数值及其不确定度构成了不确定度中给定数量的有效数字。
fvalue的Python项目详细描述
py格式值
使用适当的有效数字和匹配的小数位,格式化实验值及其不确定度。在
安装
要安装fvalue
,请运行:
pip install fvalue
示例
以下示例展示了库的核心功能。在
^{pr2}$使用
使用FormattedValue
的实例生成实验量及其不确定性的字符串表示。
值的错误中有效数字的数目在实例化时设置。
值的小数位数始终与格式化字符串中的错误的小数位匹配。
小指数是用科学数字自动格式化的小数值。在
舍入
格式化中使用的舍入策略是decimal
库的取整策略,即:ROUND_HALF_EVEN
、ROUND_05UP
、ROUND_CEILING
、ROUND_DOWN
、ROUND_FLOOR
、ROUND_HALF_DOWN
、ROUND_HALF_UP
和{FormattedValue.RoundingOption
的枚举使用。
默认情况下,ROUND_HALF_EVEN
用于减轻某些偏差。在
模板
模板允许在字符串中放置舍入值、误差、十进制指数和可选单位。
使用formatted
实例的formatted
方法,可以使用字符串和可调用模板。在
如果给定模板是字符串,则:
{0}
对应舍入值{1}
对应舍入误差{2}
对应于科学记数法中的十进制指数{3}
对应于单位。在
例如,"({0} ± {1}) x 10^{2} {3}"
将为值为10
、错误1
、单位为"m"
的格式化值生成{
如果一个给定的模板是一个函数,那么它应该具有类型签名Callable[[str, str, str, str], str]
,参数为(value: str, error: str, exponent: str, units: str) -> str
。
一个这样的模板可以在FormattedValue.NATURAL_TEMPLATE
访问。在
可以使用各种模板来加快格式化字符串的生成。
默认模板用于SIUNITX,可在FormattedValue.SIUNITX_TEMPLATE
访问,并生成"\SI{{0} \pm {1} e{2}}{{3}}"
形式的字符串。
其他模板包括:Formatted.SIUNITX_VALUE_TEMPLATE
,Formatted.SIUNITX_ERROR_TEMPLATE
,Formatted.SIUNITX_NUM_TEMPLATE
,Formatted.SIUNITX_NUM_VALUE_TEMPLATE
,Formatted.SIUNITX_NUM_ERROR_TEMPLATE
。在
乘数
FormattedValue
实例的formatted
方法允许对实例的值和错误应用乘数。
这样就可以使用国际单位制进行数据处理,并在报告中使用带前缀的单位来表示结果。在
关于
作者
- Marc Antoine Ouimet-MartyO256
许可证
这个项目是由麻省理工学院授权的。参见LICENSE.md 详细信息请存档。在
- 项目
标签: