# BHResist
A pure python library for computing thermal resistance within single-u, double-u, and coaxial grouted borehole heat exchangers. For single and double u-tube configurations, the methods use the 1st-order closed-form multipole approximations, which typically produces results with less than 1% error when compared to the 10th-order multipole method. Coaxial borehole methods apply a simple 1D resistance network method.
This is intended to be a lightweight library that can be easily imported into any other Python tool, with no bulky dependencies.
## Citation
Mitchell, Matt, Adams, Sonja, Lee, Edwin, and Swindler, Alexander. BHResist [SWR-25-57]. Computer Software. https://github.com/NREL/BHResist. USDOE Office of Energy Efficiency and Renewable Energy (EERE), Renewable Power Office. Geothermal Technologies Office. 04 Apr. 2025. Web. doi:10.11578/dc.20250421.3.
## References
Hellström, G. 1991. "Ground Heat Storage: Thermal Analyses of Duct Storage Systems." PhD dissertation. Department of Mathematical Physics, University of Lund, Sweden.
Grundmann, R.M. 2016 "Improved design methods for ground heat exchangers." Master’s thesis, Oklahoma State University.
Javed, S. and J.D. Spitler. 2016. "Calculation of borehole thermal resistance." In _Advances in Ground-Source Heat Pump Systems_. Ed. S.J. Rees. Woodhead Publishing. https://doi.org/10.1016/B978-0-08-100311-4.00003-0
Javed, S., and J.D. Spitler. 2017. "Accuracy of borehole thermal resistance calculation methods for grouted single u-tube ground heat exchangers." _Applied Energy,_ 187:790-806. https://doi.org/10.1016/j.apenergy.2016.11.079
Claesson, J., and S. Javed. 2019. "Explicit multipole formulas and thermal network models for calculating thermal resistances of double U-pipe borehole heat exchangers." _Science and Technology for the Built Environment,_ 25(8) pp. 980–992. https://doi.org/10.1080/23744731.2019.1620565
Raw data
{
"_id": null,
"home_page": "https://github.com/NREL/BHResist",
"name": "BHResist",
"maintainer": null,
"docs_url": null,
"requires_python": "<3.14,>=3.10",
"maintainer_email": null,
"keywords": null,
"author": "Matt Mitchell",
"author_email": "mitchute@gmail.com",
"download_url": "https://files.pythonhosted.org/packages/fa/7f/84b627815e8b5d1a1e7954fd087d0bb6f657cd154d7bc63545143431a46b/bhresist-0.2.0.tar.gz",
"platform": null,
"description": "# BHResist\n\nA pure python library for computing thermal resistance within single-u, double-u, and coaxial grouted borehole heat exchangers. For single and double u-tube configurations, the methods use the 1st-order closed-form multipole approximations, which typically produces results with less than 1% error when compared to the 10th-order multipole method. Coaxial borehole methods apply a simple 1D resistance network method.\n\nThis is intended to be a lightweight library that can be easily imported into any other Python tool, with no bulky dependencies.\n\n## Citation\n\nMitchell, Matt, Adams, Sonja, Lee, Edwin, and Swindler, Alexander. BHResist [SWR-25-57]. Computer Software. https://github.com/NREL/BHResist. USDOE Office of Energy Efficiency and Renewable Energy (EERE), Renewable Power Office. Geothermal Technologies Office. 04 Apr. 2025. Web. doi:10.11578/dc.20250421.3.\n\n## References\n\nHellstr\u00f6m, G. 1991. \"Ground Heat Storage: Thermal Analyses of Duct Storage Systems.\" PhD dissertation. Department of Mathematical Physics, University of Lund, Sweden.\n\nGrundmann, R.M. 2016 \"Improved design methods for ground heat exchangers.\" Master\u2019s thesis, Oklahoma State University.\n\nJaved, S. and J.D. Spitler. 2016. \"Calculation of borehole thermal resistance.\" In _Advances in Ground-Source Heat Pump Systems_. Ed. S.J. Rees. Woodhead Publishing. https://doi.org/10.1016/B978-0-08-100311-4.00003-0\n\nJaved, S., and J.D. Spitler. 2017. \"Accuracy of borehole thermal resistance calculation methods for grouted single u-tube ground heat exchangers.\" _Applied Energy,_ 187:790-806. https://doi.org/10.1016/j.apenergy.2016.11.079\n\nClaesson, J., and S. Javed. 2019. \"Explicit multipole formulas and thermal network models for calculating thermal resistances of double U-pipe borehole heat exchangers.\" _Science and Technology for the Built Environment,_ 25(8) pp. 980\u2013992. https://doi.org/10.1080/23744731.2019.1620565\n",
"bugtrack_url": null,
"license": "BSD-3-Clause",
"summary": "Functionality to compute the thermal resistance of borehole heat exchangers",
"version": "0.2.0",
"project_urls": {
"Homepage": "https://github.com/NREL/BHResist",
"Repository": "https://github.com/NREL/BHResist"
},
"split_keywords": [],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "4e4239e7acabc3e1a3dcc2f23db0971d87df0c2e22f994089866d127282f098d",
"md5": "eeedeeee90d8b665d5f76eae562abb84",
"sha256": "b097543cd233ee49ec7fb35459945e7ec7159ae5c813123c4530a26d9de70a42"
},
"downloads": -1,
"filename": "bhresist-0.2.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "eeedeeee90d8b665d5f76eae562abb84",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": "<3.14,>=3.10",
"size": 23675,
"upload_time": "2025-07-21T16:48:23",
"upload_time_iso_8601": "2025-07-21T16:48:23.420745Z",
"url": "https://files.pythonhosted.org/packages/4e/42/39e7acabc3e1a3dcc2f23db0971d87df0c2e22f994089866d127282f098d/bhresist-0.2.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "fa7f84b627815e8b5d1a1e7954fd087d0bb6f657cd154d7bc63545143431a46b",
"md5": "a0869eb1b92c7b065fa747a1b22151e7",
"sha256": "6fee023c9cb92d0f780af9a15b1acf1cf0993fe96bf01b55c30539094ad5911f"
},
"downloads": -1,
"filename": "bhresist-0.2.0.tar.gz",
"has_sig": false,
"md5_digest": "a0869eb1b92c7b065fa747a1b22151e7",
"packagetype": "sdist",
"python_version": "source",
"requires_python": "<3.14,>=3.10",
"size": 15899,
"upload_time": "2025-07-21T16:48:24",
"upload_time_iso_8601": "2025-07-21T16:48:24.576507Z",
"url": "https://files.pythonhosted.org/packages/fa/7f/84b627815e8b5d1a1e7954fd087d0bb6f657cd154d7bc63545143431a46b/bhresist-0.2.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-07-21 16:48:24",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "NREL",
"github_project": "BHResist",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "bhresist"
}
JSON
