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='jgomercr@upv.es',
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