【亲测免费】 iapws开源项目安装与使用教程

1. 项目目录结构及介绍

该项目的主要目录结构如下：

iapws/
├── circleci/             # CircleCI配置文件目录
├── docs/                 # 项目文档目录
├── iapws/                # 项目核心代码目录
│   ├── __init__.py       # 初始化文件
│   ├── iapws97.py        # IAPWS-IF97标准实现
│   ├── iapws95.py        # IAPWS-95标准实现
│   ├── iapws06.py        # IAPWS-06标准实现（冰）
│   ├── iapws08.py        # IAPWS-08标准实现（海水）
│   ├── iapws17.py        # IAPWS-17标准实现（重水）
│   └── _Ice.py           # 冰的性质计算
├── .gitignore            # Git忽略文件配置
├── LICENSE               # 许可证文件
├── MANIFEST.in           # 打包配置文件
├── README.rst            # 项目说明文件
├── appveyor.yml          # Appveyor配置文件
├── plots.py              # 绘图示例代码
├── setup.py              # 安装配置文件
├── test.py               # 测试代码
└── readthedocs.yml       # ReadTheDocs配置文件

目录详细介绍

• circleci/: 包含CircleCI持续集成服务的配置文件。
• docs/: 存放项目的相关文档，用于生成在线文档。
• iapws/: 核心代码目录，包含各个IAPWS标准的Python实现。
• .gitignore: 指定Git忽略的文件和目录。
• LICENSE: 项目许可证文件，本项目使用GPL-3.0许可证。
• MANIFEST.in: 用于打包时包含或排除某些文件。
• README.rst: 项目说明文件，包含项目简介、安装方法、使用示例等。
• appveyor.yml: Appveyor持续集成服务的配置文件。
• plots.py: 示例代码，用于绘制相关图表。
• setup.py: 项目安装配置文件，用于定义项目的依赖和安装信息。
• test.py: 项目测试代码，用于验证代码的正确性。
• readthedocs.yml: ReadTheDocs在线文档生成配置文件。

2. 项目的启动文件介绍

项目的启动文件主要是setup.py，该文件用于定义项目的安装配置，包括项目名称、版本、作者、依赖等信息。以下是setup.py的主要内容：

from setuptools import setup, find_packages

setup(
    name='iapws',
    version='1.5.2',
    author='Jorge Gómez de la Cruz',
    author_email='[e-mail]',
    description='Python library for IAPWS standard calculation of water and steam properties',
    long_description=open('README.rst').read(),
    url='https://github.com/jjgomera/iapws',
    license='GPL-3.0',
    packages=find_packages(),
    install_requires=[
        'numpy',
        'scipy'
    ],
    classifiers=[
        'Development Status :: 5 - Production/Stable',
        'Intended Audience :: Science/Research',
        'License :: OSI Approved :: GNU General Public License v3 (GPLv3)',
        'Programming Language :: Python :: 2.7',
        'Programming Language :: Python :: 3.4',
        'Programming Language :: Python :: 3.5',
        'Programming Language :: Python :: 3.6',
        'Programming Language :: Python :: 3.7',
        'Programming Language :: Python :: 3.8',
        'Topic :: Scientific/Engineering :: Physics'
    ]
)

3. 项目的配置文件介绍

项目中的配置文件主要包括以下几个：

.gitignore

.gitignore文件用于指定Git忽略的文件和目录，避免将不必要的文件提交到版本库中。以下是.gitignore的主要内容：

*.pyc
__pycache__
*.egg-info
dist
build
*.log
.DS_Store

setup.py

setup.py文件已在启动文件介绍中详细说明，这里不再赘述。

MANIFEST.in

MANIFEST.in文件用于在打包时包含或排除某些文件。以下是MANIFEST.in的主要内容：

include README.rst
include LICENSE

readthedocs.yml

readthedocs.yml文件用于配置ReadTheDocs在线文档生成服务。以下是readthedocs.yml的主要内容：

version: 2
python:
  version: 3.7
  install:
    - requirements: docs/requirements.txt