PDGRound allows you to round a number with an uncertainty using the PDG rounding rules.
Add this line to your application's Gemfile:
gem 'pdground'And then execute:
$ bundle
Or install it yourself as:
$ gem install pdground
Pdground provides an easy to use function to round a given number with an uncertainty using the PDG rules. The rule states the following [Sec 5.3]:
The basic rule states that if the three highest order digits of the error lie between 100 and 354, we round to two significant digits. If they lie between 355 and 949, we round to one significant digit. Finally, if they lie between 950 and 999, we round up to 1000 and keep two significant digits. In all cases, the central value is given with a precision that matches that of the error
For example, given the value 12.2135 +- 0.03215 the rounded value reults in 12.214 +- 0.032 while for the value 12.2135 +- 0.06515 the rounded value reults in 12.21 +- 0.07.
Using Pdground in your code it is as simple as doing:
require 'pdground'
value = 12.2135
error = 0.06515
result = PDGRound.round(meas: value, unc: error)
puts "Rounded value: #{result[0]}"
puts "Rounded error: #{result[1]}"
# Rounded value: 12.21
# Rounded error: 0.07 Contributions to this project are only accepted in its GitLab repo If you want to contribute to improve this gem with any bug fix or new feature:
- First open an issue to discuss the bug or feature
- Place a merge request referring to the issue once agreed to include it
Tests must be added to ensure maintainability.
The gem is available as open source under the terms of the MIT License.