适度收集电能计算工具。
energy-tools的Python项目详细描述
能源工具
适度收集电能计算工具。
内容:
安装
要求
基本要求:
- python 3.6+;
- 纽比。
开发要求:
- 预提交;
- pytest;
- 捆绳。
安装能源工具
带PIP- 打开命令提示符(例如,在Windows系统上启动>;命令);
- 运行以下命令安装Energy_工具:
< > >pip install energy_tools
无PIP
如果您的系统上没有Internet访问权限或出于其他原因不想使用PIP,也可以在不使用PIP的情况下安装Energy_工具:
- 从"下载文件"下的PYPI下载并解压缩当前的Energy_工具发行版。
- 打开命令提示符(例如,在Windows上启动>;cmd),并使用命令CD导航到包含setup.py文件的文件夹<;folder>;:
< > >cd %path_to_energy_tools%\energy_tools-x.x.x\
运行以下命令安装Energy_工具:
python setup.py install
开发版本
要从Gitlab安装最新版本的Energy_工具,只需执行以下步骤:
- 下载并安装Git。
- 打开Git Shell并导航到要保存Energy_工具文件的目录。
- 运行以下命令:
< > >/c/Python36/python.exe -m venv energy_tools
cd energy_tools
git clone https://gitlab.com/miek770/energy_tools.git
source Scripts/activate
python -m pip install -U pip
pip install numpy pre-commit pytest twine
- 在存储库中导航并签出开发分支:
< > >cd energy_tools
git checkout develop
- 使用预提交安装黑色。
< > >
pre-commit install
- 将python路径设置为outer energy_tools文件夹(/energy_tools,而不是energy_tools/energy_tools)。
- 如有必要,通过pip install安装缺少的依赖项(请参阅上面的开发要求)。
< > >测试您的安装
要测试已安装的开发版本,请从energy_tools的基本目录运行pytest:
pytest
功能
能源工具
目前包括以下模块:
复杂
complex
模块包括一个改进的elecomplex
类,该类添加了以下属性(属性):阶段
,模块
elecomplex.phase
以度为单位返回复数的相位。elecomplex.module
返回复数的振幅。
complex
模块还包括一个复阻抗
函数,该函数根据提供的实际阻抗z和x/r比率返回一个改进的elecomplex
数字。
必须导入elecomplex
类才能使用其他一些工具:
fromenergy_tools.compleximportEleComplex
有关更多详细信息,请参见下面的使用方法。
能量因数
能量因素模块包括用于计算特殊计算的年度能量因数的函数。目前,它包括使用系数
和损失系数
功能。
其他
misc
模块包括操作阻抗的基本功能,包括serie
、parallel
、zcap
和zind
。它们分别计算串联阻抗、并联阻抗、电容阻抗和电感阻抗。
每单位
每个单元的模块包括返回基本电流、阻抗和功率的功能。
相量
相量
模块包括一种新的数据类型相量
用于电力系统中使用的电气相量。
相位由振幅和相位定义。可以使用这些参数创建实例,也可以通过提供复振幅(在这种情况下,将忽略相位)来创建实例。支持多种操作,包括:加法、减法、乘法、除法、乘幂、求逆和与另一相量、浮点或整数相等。
它还以这种形式提供了一个很好的表示:120.000@0.000°
属性:
- amp:无量纲相量振幅。
- pha:相量的相位,单位为度。
- 实:相量的实部(解释为复数)。
- imag:相量的虚部(解释为复数)。
相量
模块还包括功能序列
和相量
。前者从A相、B相和C相的电压中恢复A相的顺序电压。后者则相反,即它从A相的顺序电压返回A相、B相和C相的电压。
用法
示例用法可在测试目录中找到。大多数这些工具都很简单(或者目标明确),因此测试和文档字符串应该足够有用。
如上文所述,为了使许多其他工具可用,必须导入elecomplex
类:
fromenergy_tools.compleximportEleComplex
当以这种方式导入改进的elecomplex
类型时,以下调用将导致变量a
成为energy\u tools.complex.elecomplex
实例,如预期的那样:
pip install energy_tools
0
但是,隐式声明复数将返回内置的complex
类型:
pip install energy_tools
1
贡献
如果您想贡献,请按照上面的开发版本说明进行操作,并参考项目的贡献指南。
推荐PyPI第三方库
- 打开命令提示符(例如,在Windows系统上启动>;命令);
- 运行以下命令安装Energy_工具: < > >
- 从"下载文件"下的PYPI下载并解压缩当前的Energy_工具发行版。
- 打开命令提示符(例如,在Windows上启动>;cmd),并使用命令CD导航到包含setup.py文件的文件夹<;folder>;: < > >
- 下载并安装Git。
- 打开Git Shell并导航到要保存Energy_工具文件的目录。
- 运行以下命令: < > >
- 在存储库中导航并签出开发分支: < > >
- 使用预提交安装黑色。
< > >
pre-commit install
- 将python路径设置为outer energy_tools文件夹(/energy_tools,而不是energy_tools/energy_tools)。
- 如有必要,通过pip install安装缺少的依赖项(请参阅上面的开发要求)。 < > >
elecomplex.phase
以度为单位返回复数的相位。elecomplex.module
返回复数的振幅。- amp:无量纲相量振幅。
- pha:相量的相位,单位为度。
- 实:相量的实部(解释为复数)。
- imag:相量的虚部(解释为复数)。
测试您的安装
要测试已安装的开发版本,请从energy_tools的基本目录运行pytest:
pytest
功能
能源工具
目前包括以下模块:复杂
complex
模块包括一个改进的elecomplex
类,该类添加了以下属性(属性):阶段
,模块
complex
模块还包括一个复阻抗
函数,该函数根据提供的实际阻抗z和x/r比率返回一个改进的elecomplex
数字。必须导入
elecomplex
类才能使用其他一些工具:fromenergy_tools.compleximportEleComplex
有关更多详细信息,请参见下面的使用方法。
能量因数
能量因素模块包括用于计算特殊计算的年度能量因数的函数。目前,它包括
使用系数
和损失系数
功能。其他
misc
模块包括操作阻抗的基本功能,包括serie
、parallel
、zcap
和zind
。它们分别计算串联阻抗、并联阻抗、电容阻抗和电感阻抗。每单位
每个单元的
模块包括返回基本电流、阻抗和功率的功能。
相量
相量
模块包括一种新的数据类型相量
用于电力系统中使用的电气相量。相位由振幅和相位定义。可以使用这些参数创建实例,也可以通过提供复振幅(在这种情况下,将忽略相位)来创建实例。支持多种操作,包括:加法、减法、乘法、除法、乘幂、求逆和与另一相量、浮点或整数相等。
它还以这种形式提供了一个很好的表示:120.000@0.000°
属性:
相量
模块还包括功能序列
和相量
。前者从A相、B相和C相的电压中恢复A相的顺序电压。后者则相反,即它从A相的顺序电压返回A相、B相和C相的电压。用法
示例用法可在测试目录中找到。大多数这些工具都很简单(或者目标明确),因此测试和文档字符串应该足够有用。
如上文所述,为了使许多其他工具可用,必须导入
elecomplex
类:fromenergy_tools.compleximportEleComplex
当以这种方式导入改进的
elecomplex
类型时,以下调用将导致变量a
成为energy\u tools.complex.elecomplex
实例,如预期的那样:
0pip install energy_tools
但是,隐式声明复数将返回内置的
complex
类型:
1pip install energy_tools
贡献
如果您想贡献,请按照上面的开发版本说明进行操作,并参考项目的贡献指南。
推荐PyPI第三方库
pip install energy_tools
无PIP
如果您的系统上没有Internet访问权限或出于其他原因不想使用PIP,也可以在不使用PIP的情况下安装Energy_工具:
cd %path_to_energy_tools%\energy_tools-x.x.x\
运行以下命令安装Energy_工具:
python setup.py install
开发版本
要从Gitlab安装最新版本的Energy_工具,只需执行以下步骤:
/c/Python36/python.exe -m venv energy_tools
cd energy_tools
git clone https://gitlab.com/miek770/energy_tools.git
source Scripts/activate
python -m pip install -U pip
pip install numpy pre-commit pytest twine
cd energy_tools
git checkout develop