CoolProp 安装配置教程3 条上手路径与首次热物性计算【免费下载链接】CoolPropThermophysical properties for the masses项目地址: https://gitcode.com/gh_mirrors/co/CoolProp干热力、制冷和能源方向的工程师大概都经历过这样的时刻为了查 R134a 在某个压力下的焓值翻纸质物性手册、在一堆折线图里拿尺子比划或者对着 NIST 网页一遍遍输入参数。CoolProp 就是来解决这个痛点的——它是一个开源免费的热物理性质计算库内置超过 100 种纯流体和多种混合物模型一行代码就能拿到密度、焓、熵、声速这些物性参数功能对标商业软件 REFPROP但完全开源、可免费商用。下面这份指南会带你从零装好 CoolProp 并完成第一次真实计算。我不打算按系统要求→安装→验证的老套路写而是先让你用 1 分钟跑通再带你深入。图为 CoolProp 绘制的工质温度-熵T-s关系等压线、等熵过程与状态点一目了然动手之前先过一遍环境自查清单在安装前花 30 秒对照下表勾选一下。大多数情况下你只需要第 1 项就够用了。检查项需要什么怎么确认Python 解释器Python 3.7 及以上终端执行python --versionWindows 下可能是python --version或py --versionpip 包管理器随 Python 自带终端执行pip --versionC 编译器仅源码编译时需要Windows 装 Visual Studio含 C 桌面开发组件Linux 装 gmacOS 装 Xcode 命令行工具Linux 下g --versionCMake仅源码编译时需要3.14 及以上cmake --versionGit仅源码编译时需要任意较新版本git --version 小贴士如果你只是想在 Python 里调用 CoolProp编译器和 CMake 完全可以不装。它们只在你想亲手从源码编译时才出场。最快上手两条快车道对于 90% 的用户CoolProp 根本不需要编译因为官方已经为 Windows、Linux 和 macOS 准备好了现成的安装包。这就像去应用商店下载软件而不是自己拿源码造轮子。快车道一pip 一键安装推荐打开终端执行pip install CoolProp这条命令的作用从 PyPI 下载并安装预编译的 CoolProp Python 包。做完后你应该看到终端滚动输出安装日志最后出现Successfully installed CoolProp-x.x.x字样。如果系统里同时存在 Python 2 和 Python 3可以把命令换成pip3 install CoolProp。macOS 和 Linux 用户如果遇到权限报错在前面加sudo或者使用虚拟环境推荐。快车道二conda 安装数据分析场景如果你平时用 Anaconda 管理环境直接走 conda 通道同样是一条现成的路conda install -c conda-forge coolprop这条命令的作用从 conda-forge 软件源安装 CoolProp自动处理好依赖关系。做完后你应该看到进度条走完提示done或completed。两条快车道任选其一即可安装包本身会把可执行库和 Python 接口一起装好无需额外配置环境变量。进阶玩法从源码编译适合想改底层的人CoolProp 的底层是一个 C 库如果你要移植到别的平台、定制功能或者想跟进最新的开发分支就需要自己编译。源码编译的通用流程是克隆仓库 → 用 CMake 生成构建文件 → 编译 → 安装 Python 接口。第一步克隆代码仓库git clone https://gitcode.com/gh_mirrors/co/CoolProp cd CoolProp第二步在项目根目录创建一个独立的构建目录并生成构建文件mkdir build cd build cmake .. -DCMAKE_BUILD_TYPERelease这条命令的作用让 CMake 检测你机器上的编译器生成 Makefile在 Windows 上则生成 Visual Studio 工程可把-DCMAKE_BUILD_TYPE换成-G Visual Studio 17 2022 -A x64。做完后你应该看到终端出现-- Configuring done和-- Generating done。第三步编译并安装 Python 接口make -j4 cd .. pip install .make -j4用 4 个并行任务编译 C 核心库pip install .把编译产物包装成 Python 包装进当前环境。做完后你应该看到编译进度条走完后pip 输出Successfully installed。⚠️ 注意Windows 上如果 CMake 报找不到编译器多半是 Visual Studio 没勾选C 桌面开发工作负载回到 Visual Studio Installer 补装即可。LinuxDebian/Ubuntu用户想凑齐整套编译工具可以一步到位sudo apt-get install git cmake build-essential python3-devmacOS 用户则靠 Homebrewbrew install git cmake 小贴士官方文档明确提示——大多数用户永远不需要自己编译 Python 包因为 PyPI 上已经有现成的预编译 wheel。只有在你确实需要改动底层、或目标平台没有官方包时才走这条路线。首次运行打卡让水在 1 个大气压下开口说话装完之后最激动人心的时刻来了——用一行真实代码验证安装是否成功。这段代码会查询水在 1 个大气压下的饱和温度这是热力学入门必算的一个量from CoolProp.CoolProp import PropsSI # 水在 1 atm (101325 Pa) 下的饱和温度Q0 表示饱和液态 T_sat PropsSI(T, P, 101325, Q, 0, Water) print(f水在 1 个大气压下的饱和温度: {T_sat:.2f} K)运行方式把代码存成first_run.py然后执行python first_run.py或者直接在 Python 交互式环境REPL里逐行粘贴。做完后你应该看到水在 1 个大气压下的饱和温度: 373.12 K。它意味着什么教科书上写水的标准沸点是 100°C即 373.15 K。CoolProp 给出的 373.12 K 与理论值高度吻合说明核心计算引擎和流体数据库都正常工作。再顺手验一个工程里更常用的查询——R134a 制冷剂在 300 K、1 MPa 下的密度from CoolProp.CoolProp import PropsSI rho PropsSI(D, T, 300, P, 1e6, R134a) print(fR134a 在 300K 和 1MPa 下的密度: {rho:.2f} kg/m³)看到两段脚本都输出了合理数值你的 CoolProp 就已经彻底跑通了可以正式投入使用了。避坑手册新手高频报错对照表安装和使用过程中难免踩坑这里把最高频的几类问题整理成一张速查表遇到报错直接对号入座报错现象常见原因解决办法ModuleNotFoundError: No module named CoolProp包没装上或装进了别的 Python 环境重新执行pip install CoolProp用pip list确认安装到了当前环境的解释器Command python setup.py egg_info failed走了源码安装但缺编译环境按上文进阶玩法装好编译器与 CMake 后再装或改走快车道pip install CoolPropError: cannot find -lCoolProp编译安装后库文件不在系统搜索路径Linux 下把库目录加入LD_LIBRARY_PATHmacOS 同理加入DYLD_LIBRARY_PATHValueError: T, P is not a valid input pairPropsSI 传入的状态量组合不受支持查阅官方 High-Level API 文档中列出的合法输入组合表例如饱和区需用Q配合T或PKeyError: Water之类流体名报错流体名称拼写不规范核对官方流体清单中的规范名称如Water、R134a、CO2⚠️ 特别提醒PropsSI 的参数顺序是输出量在前输入对在后。PropsSI(T, P, 101325, Q, 0, Water)表示给定压力和干度求温度如果把顺序写反结果会完全错误。输出量和输入量必须用引号包裹成字符串值则直接写数字。 小贴士拿不准某个流体叫什么名字时可以在 Python 里打印CoolProp.__fluids__查看完整支持清单一切以官方文档的流体名称为准。让它真正发挥作用三个立刻能上手的实战姿势装好只是第一步CoolProp 的价值在真实工程计算中才体现得淋漓尽致。这里给你三个马上就能玩的小场景把安装的成果用起来。姿势一算制冷剂饱和蒸气焓设计冷凝器、蒸发器时饱和线的焓值是最常用的输入from CoolProp.CoolProp import PropsSI # R134a 在 25°C 下的饱和蒸气焓 (J/kg) h_vapor PropsSI(H, T, 298.15, Q, 1, R134a) print(fR134a 25°C 饱和蒸气焓: {h_vapor:.1f} J/kg)Q1代表饱和蒸气Q0代表饱和液态这一对取值几乎覆盖了所有两相区计算。姿势二湿空气焓值计算暖通空调场景暖通领域经常要算湿空气的焓CoolProp 专门提供了HAPropsSI接口from CoolProp.HumidAirProp import HAPropsSI # 25°C、1 atm、相对湿度 50% 的湿空气焓 (J/kg 干空气) h HAPropsSI(H, T, 298.15, P, 101325, R, 0.5) print(f湿空气焓值: {h:.1f} J/kg dry air)R表示相对湿度T、P、H分别对应温度、压力和焓排列顺序可以任意调整接口很灵活。姿势三混合物的相态判定化工场景处理二元混合物时给定温度和压力CoolProp 会自动做相平衡计算判断系统处于单相还是两相。下图是官方文档中 PT 闪蒸计算的内部流程示意——初始化、稳定性分析、相分离求解一气呵成而这些都封装在PropsSI背后你只需像前面一样调用即可。图为 PT 闪蒸的内部计算流程从稳定性分析到相分离求解的完整判断逻辑from CoolProp.CoolProp import PropsSI from CoolProp.CoolProp import PhaseSI # 50% 甲烷 50% 乙烷混合物在 200 K、1 MPa 下的相态 phase PhaseSI(T, 200, P, 1e6, HEOS::Methane[0.5]Ethane[0.5]) print(f混合物相态标识: {phase})相态标识会是liquid、vapor或two_phase中的一种配合PropsSI就能搭建出完整的相图绘制、闪蒸塔模拟等工具。到这里你已经走完了从零到能算的全过程先用一条pip install让 CoolProp 在电脑里安家再用 PropsSI 亲手算出水的饱和温度完成打卡最后用三个真实场景把它用了起来。CoolProp 的能力远不止这些——它还有查找表加速TTSE、SVD 压缩表格后端SVDSBTL、超过 100 种流体的状态方程库以及 Python、MATLAB、Excel、Fortran、C# 等十余种语言接口。想深入探索时建议从官方文档中的 High-Level API 参数表读起那里列出了全部输入输出的属性名和合法组合流体清单和混合物命名规范则在 Fluid Properties 文档中有完整列表。所有内容都以官方文档为准。去打开你的终端跑出第一行PropsSI吧——你的热力学计算从此不再依赖翻手册。【免费下载链接】CoolPropThermophysical properties for the masses项目地址: https://gitcode.com/gh_mirrors/co/CoolProp创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
CoolProp 安装配置教程3 条上手路径与首次热物性计算【免费下载链接】CoolPropThermophysical properties for the masses项目地址: https://gitcode.com/gh_mirrors/co/CoolProp干热力、制冷和能源方向的工程师大概都经历过这样的时刻为了查 R134a 在某个压力下的焓值翻纸质物性手册、在一堆折线图里拿尺子比划或者对着 NIST 网页一遍遍输入参数。CoolProp 就是来解决这个痛点的——它是一个开源免费的热物理性质计算库内置超过 100 种纯流体和多种混合物模型一行代码就能拿到密度、焓、熵、声速这些物性参数功能对标商业软件 REFPROP但完全开源、可免费商用。下面这份指南会带你从零装好 CoolProp 并完成第一次真实计算。我不打算按系统要求→安装→验证的老套路写而是先让你用 1 分钟跑通再带你深入。图为 CoolProp 绘制的工质温度-熵T-s关系等压线、等熵过程与状态点一目了然动手之前先过一遍环境自查清单在安装前花 30 秒对照下表勾选一下。大多数情况下你只需要第 1 项就够用了。检查项需要什么怎么确认Python 解释器Python 3.7 及以上终端执行python --versionWindows 下可能是python --version或py --versionpip 包管理器随 Python 自带终端执行pip --versionC 编译器仅源码编译时需要Windows 装 Visual Studio含 C 桌面开发组件Linux 装 gmacOS 装 Xcode 命令行工具Linux 下g --versionCMake仅源码编译时需要3.14 及以上cmake --versionGit仅源码编译时需要任意较新版本git --version 小贴士如果你只是想在 Python 里调用 CoolProp编译器和 CMake 完全可以不装。它们只在你想亲手从源码编译时才出场。最快上手两条快车道对于 90% 的用户CoolProp 根本不需要编译因为官方已经为 Windows、Linux 和 macOS 准备好了现成的安装包。这就像去应用商店下载软件而不是自己拿源码造轮子。快车道一pip 一键安装推荐打开终端执行pip install CoolProp这条命令的作用从 PyPI 下载并安装预编译的 CoolProp Python 包。做完后你应该看到终端滚动输出安装日志最后出现Successfully installed CoolProp-x.x.x字样。如果系统里同时存在 Python 2 和 Python 3可以把命令换成pip3 install CoolProp。macOS 和 Linux 用户如果遇到权限报错在前面加sudo或者使用虚拟环境推荐。快车道二conda 安装数据分析场景如果你平时用 Anaconda 管理环境直接走 conda 通道同样是一条现成的路conda install -c conda-forge coolprop这条命令的作用从 conda-forge 软件源安装 CoolProp自动处理好依赖关系。做完后你应该看到进度条走完提示done或completed。两条快车道任选其一即可安装包本身会把可执行库和 Python 接口一起装好无需额外配置环境变量。进阶玩法从源码编译适合想改底层的人CoolProp 的底层是一个 C 库如果你要移植到别的平台、定制功能或者想跟进最新的开发分支就需要自己编译。源码编译的通用流程是克隆仓库 → 用 CMake 生成构建文件 → 编译 → 安装 Python 接口。第一步克隆代码仓库git clone https://gitcode.com/gh_mirrors/co/CoolProp cd CoolProp第二步在项目根目录创建一个独立的构建目录并生成构建文件mkdir build cd build cmake .. -DCMAKE_BUILD_TYPERelease这条命令的作用让 CMake 检测你机器上的编译器生成 Makefile在 Windows 上则生成 Visual Studio 工程可把-DCMAKE_BUILD_TYPE换成-G Visual Studio 17 2022 -A x64。做完后你应该看到终端出现-- Configuring done和-- Generating done。第三步编译并安装 Python 接口make -j4 cd .. pip install .make -j4用 4 个并行任务编译 C 核心库pip install .把编译产物包装成 Python 包装进当前环境。做完后你应该看到编译进度条走完后pip 输出Successfully installed。⚠️ 注意Windows 上如果 CMake 报找不到编译器多半是 Visual Studio 没勾选C 桌面开发工作负载回到 Visual Studio Installer 补装即可。LinuxDebian/Ubuntu用户想凑齐整套编译工具可以一步到位sudo apt-get install git cmake build-essential python3-devmacOS 用户则靠 Homebrewbrew install git cmake 小贴士官方文档明确提示——大多数用户永远不需要自己编译 Python 包因为 PyPI 上已经有现成的预编译 wheel。只有在你确实需要改动底层、或目标平台没有官方包时才走这条路线。首次运行打卡让水在 1 个大气压下开口说话装完之后最激动人心的时刻来了——用一行真实代码验证安装是否成功。这段代码会查询水在 1 个大气压下的饱和温度这是热力学入门必算的一个量from CoolProp.CoolProp import PropsSI # 水在 1 atm (101325 Pa) 下的饱和温度Q0 表示饱和液态 T_sat PropsSI(T, P, 101325, Q, 0, Water) print(f水在 1 个大气压下的饱和温度: {T_sat:.2f} K)运行方式把代码存成first_run.py然后执行python first_run.py或者直接在 Python 交互式环境REPL里逐行粘贴。做完后你应该看到水在 1 个大气压下的饱和温度: 373.12 K。它意味着什么教科书上写水的标准沸点是 100°C即 373.15 K。CoolProp 给出的 373.12 K 与理论值高度吻合说明核心计算引擎和流体数据库都正常工作。再顺手验一个工程里更常用的查询——R134a 制冷剂在 300 K、1 MPa 下的密度from CoolProp.CoolProp import PropsSI rho PropsSI(D, T, 300, P, 1e6, R134a) print(fR134a 在 300K 和 1MPa 下的密度: {rho:.2f} kg/m³)看到两段脚本都输出了合理数值你的 CoolProp 就已经彻底跑通了可以正式投入使用了。避坑手册新手高频报错对照表安装和使用过程中难免踩坑这里把最高频的几类问题整理成一张速查表遇到报错直接对号入座报错现象常见原因解决办法ModuleNotFoundError: No module named CoolProp包没装上或装进了别的 Python 环境重新执行pip install CoolProp用pip list确认安装到了当前环境的解释器Command python setup.py egg_info failed走了源码安装但缺编译环境按上文进阶玩法装好编译器与 CMake 后再装或改走快车道pip install CoolPropError: cannot find -lCoolProp编译安装后库文件不在系统搜索路径Linux 下把库目录加入LD_LIBRARY_PATHmacOS 同理加入DYLD_LIBRARY_PATHValueError: T, P is not a valid input pairPropsSI 传入的状态量组合不受支持查阅官方 High-Level API 文档中列出的合法输入组合表例如饱和区需用Q配合T或PKeyError: Water之类流体名报错流体名称拼写不规范核对官方流体清单中的规范名称如Water、R134a、CO2⚠️ 特别提醒PropsSI 的参数顺序是输出量在前输入对在后。PropsSI(T, P, 101325, Q, 0, Water)表示给定压力和干度求温度如果把顺序写反结果会完全错误。输出量和输入量必须用引号包裹成字符串值则直接写数字。 小贴士拿不准某个流体叫什么名字时可以在 Python 里打印CoolProp.__fluids__查看完整支持清单一切以官方文档的流体名称为准。让它真正发挥作用三个立刻能上手的实战姿势装好只是第一步CoolProp 的价值在真实工程计算中才体现得淋漓尽致。这里给你三个马上就能玩的小场景把安装的成果用起来。姿势一算制冷剂饱和蒸气焓设计冷凝器、蒸发器时饱和线的焓值是最常用的输入from CoolProp.CoolProp import PropsSI # R134a 在 25°C 下的饱和蒸气焓 (J/kg) h_vapor PropsSI(H, T, 298.15, Q, 1, R134a) print(fR134a 25°C 饱和蒸气焓: {h_vapor:.1f} J/kg)Q1代表饱和蒸气Q0代表饱和液态这一对取值几乎覆盖了所有两相区计算。姿势二湿空气焓值计算暖通空调场景暖通领域经常要算湿空气的焓CoolProp 专门提供了HAPropsSI接口from CoolProp.HumidAirProp import HAPropsSI # 25°C、1 atm、相对湿度 50% 的湿空气焓 (J/kg 干空气) h HAPropsSI(H, T, 298.15, P, 101325, R, 0.5) print(f湿空气焓值: {h:.1f} J/kg dry air)R表示相对湿度T、P、H分别对应温度、压力和焓排列顺序可以任意调整接口很灵活。姿势三混合物的相态判定化工场景处理二元混合物时给定温度和压力CoolProp 会自动做相平衡计算判断系统处于单相还是两相。下图是官方文档中 PT 闪蒸计算的内部流程示意——初始化、稳定性分析、相分离求解一气呵成而这些都封装在PropsSI背后你只需像前面一样调用即可。图为 PT 闪蒸的内部计算流程从稳定性分析到相分离求解的完整判断逻辑from CoolProp.CoolProp import PropsSI from CoolProp.CoolProp import PhaseSI # 50% 甲烷 50% 乙烷混合物在 200 K、1 MPa 下的相态 phase PhaseSI(T, 200, P, 1e6, HEOS::Methane[0.5]Ethane[0.5]) print(f混合物相态标识: {phase})相态标识会是liquid、vapor或two_phase中的一种配合PropsSI就能搭建出完整的相图绘制、闪蒸塔模拟等工具。到这里你已经走完了从零到能算的全过程先用一条pip install让 CoolProp 在电脑里安家再用 PropsSI 亲手算出水的饱和温度完成打卡最后用三个真实场景把它用了起来。CoolProp 的能力远不止这些——它还有查找表加速TTSE、SVD 压缩表格后端SVDSBTL、超过 100 种流体的状态方程库以及 Python、MATLAB、Excel、Fortran、C# 等十余种语言接口。想深入探索时建议从官方文档中的 High-Level API 参数表读起那里列出了全部输入输出的属性名和合法组合流体清单和混合物命名规范则在 Fluid Properties 文档中有完整列表。所有内容都以官方文档为准。去打开你的终端跑出第一行PropsSI吧——你的热力学计算从此不再依赖翻手册。【免费下载链接】CoolPropThermophysical properties for the masses项目地址: https://gitcode.com/gh_mirrors/co/CoolProp创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
