Output numbers +/- error with appropriate rounding.
Project description
Introduction | Install | Default Usage | Adjusting # of Significant Figures on Error | Render Latex in Jupyter | Comments and Bug Reporting | License
Round Using Error
Introduction
This package provides opinionated tools for formatting the output of values
with known errors. The general format is value +/- error
. The values are
rounded so that the last digit reported for the value is the same order of
magnitude as the least significant digit reported on the error. The default
is to report the error to two significant figures. The opinionated
part is that the output switches automatically from decimal to scientific
notation. Scientific notation is used for values < 0.1 and > 1000.
The output is available as:
- tuple of strings (value, error, power_of_ten);
- text in format
value +/- error
; - latex in the form
value \pm error
.
Usage
Install using pip
pip install -U round_using_error
.
Default usage:
>>> from round_using_error import *
>>> rndwitherr(0.001234, 0.000241)
('1.23', '0.24', '-3')
>>> rndwitherr(1299.845, 0.124)
('1.29985', '0.00012', '3')
>>> text_rndwitherr(1299.845, 0.124)
'(1.29985 +/- 0.00012) X 10^3'
>>> latex_rndwitherr(1299.845, 0.124)
'(1.29985\\pm0.00012)\\times 10^3'
>>> rndwitherr(0.001234, 0.000241)
('1.23', '0.24', '-3')
>>> text_rndwitherr(0.001234, 0.000241)
'(1.23 +/- 0.24) X 10^-3'
>>> latex_rndwitherr(0.001234, 0.000241)
'(1.23\\pm0.24)\\times 10^-3'
>>> rndwitherr(0.1234, 0.024)
('0.123', '0.024', '')
>>> text_rndwitherr(0.1234, 0.024)
'0.123 +/- 0.024'
>>> latex_rndwitherr(0.1234, 0.024)
'0.123\\pm0.024'
Adjusting significant figures on error
>>> from round_using_error import *
>>> latex_rndwitherr(0.1234, 0.024)
'0.123\\pm0.024'
>>> rndwitherr(0.001234, 0.000241, errdig = 1)
('1.2', '0.2', '-3')
>>> rndwitherr(0.001234, 0.000241, errdig = 3)
('1.234', '0.241', '-3')
>>> text_rndwitherr(0.001234, 0.000241, errdig = 3)
'(1.234 +/- 0.241) X 10^-3'
>>> latex_rndwitherr(0.001234, 0.000241, errdig = 3)
'(1.234\\pm0.241)\\times 10^-3'
Render Latex in Jupyter
Issues or Comments
Ideas, suggestions, bug reports and general comments are welcome . Please use the github repository issues tracker: https://github.com/gutow/round_using_error/issues.
This software is distributed under the GNU V3 license
This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version. This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.
Copyright - Jonathan Gutow, 2021.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for round_using_error-1.0.2-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 728488303c61209704a7ecfe73257d79ab1bbd74bd4a3ab19fb03dfb380a771e |
|
MD5 | 5e242433267126c270ff1eb06c509f89 |
|
BLAKE2b-256 | d982b47d8d221c357cf1aef193f6491726b92d0678d902c720f3a2d4f27c6d16 |