unit_measurements 3.2.0 → 3.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 73c4d379f4412abab14612cf06d48747d0f22141b714b16ad2c10a13f6f17be2
-  data.tar.gz: f76fa7c8c2daf6eb0fcf51b710b5236cbc606d97a6644b5c51c67215d9e2420d
+  metadata.gz: 6c50e2f3f71c84f00b3b65de4e636b9497a9212cb923bc2d984d98dbb1d705f9
+  data.tar.gz: '079c32f6cd5bfbe6e1c6579274cefcf416ab4387808e32b837aa4f07028585fc'
 SHA512:
-  metadata.gz: 409878f8f87f8d5ea2eb9a9e55f7032a80d0c3d9f0be15e830791ca48ab5a007b9678b0d56bc224cc06103d1b60560f62efeacae35246cb6240e101fd9034405
-  data.tar.gz: a0b6b7230fb277ffb960f0f96575e742bc6fb3a4b3d9c976df8ad9bb4b2071c75106be487ee96fe84bea966070cdb5fe89c2a36a8e58ecce78ff85ba2278d3dc
+  metadata.gz: 96d7edaf7d57d86a087eb55c77202e30d465ce745440068d6f3f17e2cf9c83acbda65fedc6630033ee5e77af0a19c6d6dd101d9370aebe73a0990afc795c121c
+  data.tar.gz: 82cffad83e21aed77c6a8c5da32eab913ea548e55f350a2aeb2371bb4b905e6f2d715488c6c78ca888a94a21d695915035aff6493a4573192279d88ef0cf66fc

data/CHANGELOG.md

@@ -1,3 +1,27 @@
+## [3.4.0](https://github.com/shivam091/unit_measurements/compare/v3.3.0...v3.4.0) - 2023-08-29
+
+### What's new
+
+- Added ability to group units by `unit system`.
+- Added ability to set `primitive` unit for each unit system.
+- Added method `primitive?` to check whether the unit is primitive or not.
+- Added method `system_for` to find unit system by name.
+
+### What's changed
+
+- Grouped units in system and set primitive unit for those systems.
+
+----------
+
+## [3.3.0](https://github.com/shivam091/unit_measurements/compare/v3.2.0...v3.3.0) - 2023-08-28
+
+### What's new
+
+- Added unit group for `electric charge` units.
+- Added unit group for `angular velocity` units.
+
+----------
+
 ## [3.2.0](https://github.com/shivam091/unit_measurements/compare/v3.1.0...v3.2.0) - 2023-08-27
 
 ### What's new

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    unit_measurements (3.2.0)
+    unit_measurements (3.3.0)
       activesupport (~> 7.0)
 
 GEM

data/README.md

@@ -9,7 +9,7 @@ A library that encapsulate measurements and their units in Ruby.
 [![Test Coverage](https://api.codeclimate.com/v1/badges/b8aec9bffa356d108784/test_coverage)](https://codeclimate.com/github/shivam091/unit_measurements/test_coverage)
 [![License](https://img.shields.io/badge/License-MIT-blue.svg)](https://github.com/shivam091/unit_measurements/blob/main/LICENSE.md)
 
-**Harshal V. Ladhe, M.Sc. Computer Science.**
+**Harshal V. Ladhe, Master of Computer Science.**
 
 ## Introduction
 
@@ -251,28 +251,51 @@ UnitMeasurements::Weight.name
 #=> weight
 ```
 
-**See all units of the unit group:**
+**See all unit systems defined in the unit group:**
+
+```ruby
+UnitMeasurements::Length.systems
+#=> [#<UnitMeasurements::UnitSystem:0x00007fa1a46d11c0 @name=:metric, @primitive=#<UnitMeasurements::Unit: m (meter, meters, metre, metres)>, @units=[]>]
+```
+
+**Finding unit system within the unit group:**
+
+```ruby
+UnitMeasurements::Length.system_for(:imperial)
+#=> #<UnitMeasurements::UnitSystem:0x00007f87a348e680
+#     @name=:imperial,
+#     @primitive=#<UnitMeasurements::Unit: in (", inch, inches)>,
+#     @units=[#<UnitMeasurements::Unit: in (", inch, inches)>, #<UnitMeasurements::Unit: ft (', feet, foot)>, ...]>
+```
+
+**See all units of the unit group/unit system:**
 
 ```ruby
 UnitMeasurements::Weight.units
 #=> [#<UnitMeasurements::Unit: g (gram, gramme, grammes, grams)>, ..., ...]
+UnitMeasurements::Length.system_for(:imperial).units
+#=> [#<UnitMeasurements::Unit: in (", inch, inches)>, #<UnitMeasurements::Unit: ft (', feet, foot)>, ...]
 ```
 
-**See names of all valid units of the unit group:**
+**See names of all valid units of the unit group/unit system:**
 
 ```ruby
 UnitMeasurements::Weight.unit_names
 #=> ["g", "kg", "lb", "oz", ...]
+UnitMeasurements::Length.system_for(:imperial).unit_names
+#=> ["ft", "in", "mi", "yd"]
 ```
 
-**See all valid units of the unit group along with their aliases:**
+**See all valid units of the unit group/unit system along with their aliases:**
 
 ```ruby
 UnitMeasurements::Weight.unit_names_with_aliases
 #=> ["g", "gram", "gramme", "grammes", "grams", "kg", "kilogram", "kilogramme", "kilogrammes", "kilograms", "lb", "ounce", "ounces", "oz", "pound", "pounds", ...]
+UnitMeasurements::Length.system_for(:imperial).unit_names_with_aliases
+#=> ["feet", "foot", "ft", "in", "inch", "inches", "mi", "mile", "miles", "yard", "yards", "yd"]
 ```
 
-**Finding units within the unit group:**
+**Finding units within the unit group/unit system:**
 
 You can use `#unit_for` or `#unit_for!` (aliased as `#[]`) to find units within
 the unit group. `#unit_for!` method returns error if a unit is not present in the
@@ -287,28 +310,43 @@ UnitMeasurements::Weight.unit_for!(:g)
 #=> #<UnitMeasurements::Unit: g (gram, gramme, grammes, grams)>
 UnitMeasurements::Weight.unit_for!(:z)
 #=> Invalid unit: 'z'. (UnitMeasurements::UnitError)
+
+UnitMeasurements::Length.system_for(:imperial).unit_for(:in)
+#=> #<UnitMeasurements::Unit: in (", inch, inches)>
+UnitMeasurements::Length.system_for(:imperial).unit_for(:m)
+#=> nil
+UnitMeasurements::Length.system_for(:imperial).unit_for!(:in)
+#=> #<UnitMeasurements::Unit: in (", inch, inches)>
+UnitMeasurements::Length.system_for(:imperial).unit_for!(:m)
+#=> Invalid unit: 'm'. (UnitMeasurements::UnitError)
 ```
 
-**Finding whether the unit is defined within the unit group:**
+**Finding whether the unit is defined within the unit group/unit system:**
 
 ```ruby
 UnitMeasurements::Weight.defined?(:g)
 #=> true
-UnitMeasurements::Weight.defined?(:kg)
-#=> true
 UnitMeasurements::Weight.defined?(:gramme)
 #=> false
+
+UnitMeasurements::Length.system_for(:metric).defined?(:m)
+#=> true
+UnitMeasurements::Length.system_for(:metric).defined?(:in)
+#=> false
 ```
 
-**Check if the unit is a valid unit or alias within the unit group:**
+**Check if the unit is a valid unit or alias within the unit group/unit system:**
 
 ```ruby
 UnitMeasurements::Weight.unit_or_alias?(:g)
 #=> true
-UnitMeasurements::Weight.unit_or_alias?(:kg)
-#=> true
 UnitMeasurements::Weight.unit_or_alias?(:gramme)
 #=> true
+
+UnitMeasurements::Length.system_for(:metric).unit_or_alias?(:m)
+#=> true
+UnitMeasurements::Length.system_for(:metric).unit_or_alias?(:metre)
+#=> true
 ```
 
 ### Comparisons
@@ -338,6 +376,7 @@ UnitMeasurements::Length.new(1, :ft).clamp(UnitMeasurements::Length.new(13, :in)
 You have ability to perform arithmetic operations on measurements with the same or
 different units within a same unit group. You can perform arithmetic operations on
 measurement by either other compatible measurement or number.
+In cases of different units, the left hand side takes precedence:
 
 **Methods:**
 1. `#+` - Adds the other measurement quantity or number to the measurement.
@@ -480,24 +519,24 @@ use `UnitMeasurements.build` in order to define units within it:
 If the unit is supporting [si prefixes](#si-units-support), you can use `si_unit` method to build it.
 If you build unit using `si_unit`, the unit will be added along with all SI prefixes for it.
 
+For convenience, you also have ability to group units by the unit system and set primitive unit for each unit system using `system` and `primitive` methods.
+
 ```ruby
 UnitMeasurements::Time = UnitMeasurements.build do
-  unit :s, aliases: [:second, :seconds]
-
-  # Add units to the group, along with their conversion multipliers.
-  unit :min, value: "60 s", aliases: [:hour, :hours]
+  # Group units by the unit system name.
+  system :metric do
+    # Set primitive unit for the unit system.
+    primitive :s
 
-  # You can also specify unit value as an array.
-  unit :h, value: [60, :min], aliases: [:day, :days]
-end
-```
+    # Add a SI unit to the unit group
+    si_unit :s, aliases: [:second, :seconds]
 
-```ruby
-UnitMeasurements::Time = UnitMeasurements.build do
-  # Add a SI unit to the unit group
-  si_unit :s, aliases: [:second, :seconds]
+    # Add units to the group, along with their conversion multipliers.
+    unit :min, value: "60 s", aliases: [:hour, :hours]
 
-  unit :min, value: "60 s", aliases: [:minute, :minutes]
+    # You can also specify unit value as an array.
+    unit :h, value: [60, :min], aliases: [:day, :days]
+  end
 end
 ```
 

data/lib/unit_measurements/base.rb

@@ -24,6 +24,8 @@ end
 
 require "unit_measurements/unit_group_builder"
 require "unit_measurements/unit"
+require "unit_measurements/unit_methods"
+require "unit_measurements/unit_system"
 require "unit_measurements/unit_group"
 require "unit_measurements/arithmetic"
 require "unit_measurements/comparison"

data/lib/unit_measurements/measurement.rb

@@ -73,7 +73,7 @@ module UnitMeasurements
 
       def_delegators :unit_group, :units, :unit_names, :unit_with_name_and_aliases,
                      :unit_names_with_aliases, :unit_for, :unit_for!, :defined?,
-                     :unit_or_alias?, :[]
+                     :unit_or_alias?, :[], :systems, :system_for
 
       def parse(input)
         input = Normalizer.normalize(input)

data/lib/unit_measurements/unit_group.rb

@@ -4,48 +4,17 @@
 
 module UnitMeasurements
   class UnitGroup
-    attr_reader :units
+    include UnitMethods
 
-    def initialize(units)
-      @units = units.map { |unit| unit.with(unit_group: self) }
-    end
-
-    def unit_for(name)
-      unit_name_to_unit(name)
-    end
-
-    def unit_for!(name)
-      unit = unit_for(name)
-      raise UnitError, name unless unit
-      unit
-    end
-    alias_method :[], :unit_for!
-
-    def unit_with_name_and_aliases
-      units.each_with_object({}) do |unit, hash|
-        unit.names.each { |name| hash[name.to_s] = unit }
-      end
-    end
+    attr_reader :units, :systems
 
-    def unit_names
-      units.map(&:name).sort
-    end
-
-    def unit_names_with_aliases
-      units.flat_map(&:names).sort
-    end
-
-    def unit_name_to_unit(name)
-      unit_with_name_and_aliases[name.to_s]
-    end
-
-    def defined?(name)
-      unit = unit_for(name)
-      unit ? unit.name == name.to_s : false
+    def initialize(units, systems)
+      @units = units.map { |unit| unit.with(unit_group: self) }
+      @systems = systems
     end
 
-    def unit_or_alias?(name)
-      !!unit_for(name)
+    def system_for(system_name)
+      @systems.find { |system| system.name.to_s == system_name.to_s }
     end
   end
 end

data/lib/unit_measurements/unit_group_builder.rb

@@ -7,7 +7,7 @@ module UnitMeasurements
     attr_reader :units
 
     def initialize
-      @units = []
+      @units, @systems = [], []
     end
 
     def unit(name, value: 1.0, aliases: [])
@@ -19,7 +19,19 @@ module UnitMeasurements
     end
 
     def build
-      UnitGroup.new(@units)
+      UnitGroup.new(@units, @systems)
+    end
+
+    def system(system_name, &block)
+      @current_system = find_or_create_system(system_name)
+      instance_eval(&block) if block_given?
+      @current_system.set_primitive(@current_primitive) if @current_primitive
+    ensure
+      @current_primitive, @current_system = nil, nil
+    end
+
+    def primitive(primitive)
+      @current_primitive = primitive
     end
 
     private
@@ -40,6 +52,7 @@ module UnitMeasurements
     def build_unit(name, value:, aliases:)
       unit = Unit.new(name, value: value, aliases: aliases)
       check_for_duplicate_unit_names!(unit)
+      add_unit_to_system(unit)
 
       unit
     end
@@ -51,5 +64,22 @@ module UnitMeasurements
         raise UnitAlreadyDefinedError.new(unit.name)
       end
     end
+
+    def find_system(name)
+      @systems.find { |system| system.name.to_s == name.to_s }
+    end
+
+    def find_or_create_system(system_name)
+      system = find_system(system_name)
+      unless system
+        system = UnitSystem.new(system_name)
+        @systems << system
+      end
+      system
+    end
+
+    def add_unit_to_system(unit)
+      @current_system.add_unit(unit) if @current_system
+    end
   end
 end

data/lib/unit_measurements/unit_groups/acceleration.rb

@@ -3,9 +3,19 @@
 # -*- warn_indent: true -*-
 
 UnitMeasurements::Acceleration = UnitMeasurements.build do
-  si_unit :"m/s²", aliases: [:"m/s^2", :"m·s⁻²", :"meter per second squared", :"meters per second squared", :"metre per second squared", :"metres per second squared"]
+  system :metric do
+    primitive :"m/s²"
+
+    si_unit :"m/s²", aliases: [:"m/s^2", :"m·s⁻²", :"meter per second squared", :"meters per second squared", :"metre per second squared", :"metres per second squared"]
+  end
+
+  system :imperial do
+    unit :"in/s²", value: "0.0254 m/s²", aliases: [:"in/s^2", :"in·s⁻²", :"inch per second squared", :"inches per second squared"]
+  end
+
+  system :foot_pound_second do
+    unit :"ft/s²", value: "0.3048 m/s²", aliases: [:"ft/s^2", :"ft·s⁻²", :"foot per second squared", :"feet per second squared"]
+  end
 
-  unit :"in/s²", value: "0.0254 m/s²", aliases: [:"in/s^2", :"in·s⁻²", :"inch per second squared", :"inches per second squared"]
-  unit :"ft/s²", value: "0.3048 m/s²", aliases: [:"ft/s^2", :"ft·s⁻²", :"foot per second squared", :"feet per second squared"]
   unit :"Kn/s", value: "0.5144444 m/s²", aliases: [:"knot per second", :"knots per second"]
 end

data/lib/unit_measurements/unit_groups/all.rb

@@ -17,11 +17,13 @@ require_relative "weight"
 require_relative "area"
 require_relative "volume"
 require_relative "density"
-require_relative "force"
-require_relative "voltage"
 require_relative "velocity"
 require_relative "acceleration"
+require_relative "angular_velocity"
 require_relative "angular_acceleration"
+require_relative "force"
+require_relative "voltage"
+require_relative "electric_charge"
 
 ## Other units
 

data/lib/unit_measurements/unit_groups/amount_of_substance.rb

@@ -3,7 +3,11 @@
 # -*- warn_indent: true -*-
 
 UnitMeasurements::AmountOfSubstance = UnitMeasurements.build do
-  si_unit :mol, aliases: [:mole, :moles]
+  system :cgs do
+    primitive :mol
+
+    si_unit :mol, aliases: [:mole, :moles]
+  end
 
   unit :NA, value: "1.6605389210322e-24 mol", aliases: [:"avogadro constant"]
 end

data/lib/unit_measurements/unit_groups/angular_acceleration.rb

@@ -3,8 +3,12 @@
 # -*- warn_indent: true -*-
 
 UnitMeasurements::AngularAcceleration = UnitMeasurements.build do
-  si_unit :"rad/s²", aliases: [:"rad/s^2", :"rad·s⁻²", :"radian per second squared", :"radians per second squared"]
+  system :metric do
+    primitive :"rad/s²"
+
+    si_unit :"rad/s²", aliases: [:"rad/s^2", :"rad·s⁻²", :"radian per second squared", :"radians per second squared"]
+    unit :"gon/s²", value: [(Math::PI / 200), :"rad/s²"], aliases: [:"gon/s^2", :"ᵍ/s²", :"gon·s⁻²", :"gradian per second squared", :"gradians per second squared"]
+  end
 
   unit :"deg/s²", value: [(Math::PI / 180), :"rad/s²"], aliases: [:"deg/s^2", :"°/s²", :"deg·s⁻²", :"degree per second squared", :"degrees per second squared"]
-  unit :"gon/s²", value: [(Math::PI / 200), :"rad/s²"], aliases: [:"gon/s^2", :"ᵍ/s²", :"gon·s⁻²", :"gradian per second squared", :"gradians per second squared"]
 end

data/lib/unit_measurements/unit_groups/angular_velocity.rb

@@ -0,0 +1,25 @@
+# -*- encoding: utf-8 -*-
+# -*- frozen_string_literal: true -*-
+# -*- warn_indent: true -*-
+
+UnitMeasurements::AngularVelocity = UnitMeasurements.build do
+  system :metric do
+    primitive :"rad/s"
+
+    unit :"rad/s", aliases: [:"rad·s⁻¹", :"radian per second", :"radians per second"]
+    unit :"rad/min", value: "1/60 rad/s", aliases: [:"rad·min⁻¹", :"radian per minute", :"radians per minute"]
+    unit :"rad/h", value: "1/60 rad/min", aliases: [:"rad·h⁻¹", :"radian per hour", :"radians per hour"]
+
+    unit :"gon/s", value: [(Math::PI / 200), :"rad/s"], aliases: [:"ᵍ/s", :"gon·s⁻¹", :"gradian per second", :"gradians per second"]
+    unit :"gon/min", value: "1/60 gon/s", aliases: [:"ᵍ/min", :"gon·min⁻¹", :"gradian per minute", :"gradians per minute"]
+    unit :"gon/h", value: "1/60 gon/min", aliases: [:"ᵍ/h", :"gon·h⁻¹", :"gradian per hour", :"gradians per hour"]
+  end
+
+  unit :"deg/s", value: [(Math::PI / 180), :"rad/s"], aliases: [:"°/s", :"deg·s⁻¹", :"degree per second", :"degrees per second"]
+  unit :"deg/min", value: "1/60 deg/s", aliases: [:"°/min", :"deg·min⁻¹", :"degree per minute", :"degrees per minute"]
+  unit :"deg/h", value: "1/60 deg/min", aliases: [:"°/h", :"deg·h⁻¹", :"degree per hour", :"degrees per hour"]
+
+  unit :"rev/s", value: "360 deg/s", aliases: [:"rev·s⁻¹", :"revolution per second", :"revolutions per second"]
+  unit :"rev/min", value: "1/60 rev/s", aliases: [:"rev·min⁻¹", :"revolution per minute", :"revolutions per minute"]
+  unit :"rev/h", value: "1/60 rev/min", aliases: [:"rev·h⁻¹", :"revolution per hour", :"revolutions per hour"]
+end

data/lib/unit_measurements/unit_groups/area.rb

@@ -3,11 +3,19 @@
 # -*- warn_indent: true -*-
 
 UnitMeasurements::Area = UnitMeasurements.build do
-  unit :m², aliases: [:"m^2", :"sq m", :"square meter", :"square meters", :"square metre", :"square metres"]
+  system :metric do
+    primitive :m²
 
-  unit :km², value: "1e+6 m²", aliases: [:"km^2", :"sq km", :"square kilometer", :"square kilometers", :"square kilometre", :"square kilometres"]
-  unit :in², value: "0.00064516 m²", aliases: [:"in^2", :"sq in", :"square inch", :"square inches"]
-  unit :ft², value: "144 in²", aliases: [:"ft^2", :"sq ft", :"square foot", :"square feet"]
-  unit :yd², value: "9 ft²", aliases: [:"yd^2", :"sq yd", :"square yard", :"square yards"]
-  unit :mi², value: "3097600 yd²", aliases: [:"mi^2", :"sq mi", :"square mile", :"square miles"]
+    unit :m², aliases: [:"m^2", :"sq m", :"square meter", :"square meters", :"square metre", :"square metres"]
+    unit :km², value: "1e+6 m²", aliases: [:"km^2", :"sq km", :"square kilometer", :"square kilometers", :"square kilometre", :"square kilometres"]
+  end
+
+  system :imperial do
+    primitive :in²
+
+    unit :in², value: "0.00064516 m²", aliases: [:"in^2", :"sq in", :"square inch", :"square inches"]
+    unit :ft², value: "144 in²", aliases: [:"ft^2", :"sq ft", :"square foot", :"square feet"]
+    unit :yd², value: "9 ft²", aliases: [:"yd^2", :"sq yd", :"square yard", :"square yards"]
+    unit :mi², value: "3097600 yd²", aliases: [:"mi^2", :"sq mi", :"square mile", :"square miles"]
+  end
 end

data/lib/unit_measurements/unit_groups/density.rb

@@ -3,11 +3,15 @@
 # -*- warn_indent: true -*-
 
 UnitMeasurements::Density = UnitMeasurements.build do
-  unit :"g/m³", aliases: [:"g/m^3", :"g·m⁻³", :"gram per cubic meter", :"grams per cubic meter", :"gramme per cubic metre", :"grammes per cubic metre"]
+  system :metric do
+    primitive :"g/m³"
 
-  unit :"g/l", value: "1 kg/m³", aliases: [:"g·l⁻¹", :"gram per liter", :"grams per liter", :"gramme per litre", :"grammes per litre"]
-  unit :"g/ml", value: "1000 g/l", aliases: [:"g·ml⁻¹", :"gram per milliliter", :"grams per milliliter", :"gramme per millilitre", :"grammes per millilitre"]
+    unit :"g/m³", aliases: [:"g/m^3", :"g·m⁻³", :"gram per cubic meter", :"grams per cubic meter", :"gramme per cubic metre", :"grammes per cubic metre"]
 
-  unit :"kg/m³", value: "1000 g/m³", aliases: [:"kg/m^3", :"kg·m⁻³", :"kilogram per cubic meter", :"kilograms per cubic meter", :"kilogramme per cubic metre", :"kilogrammes per cubic metre"]
-  unit :"kg/l", value: "1e+6 g/m³", aliases: [:"kg·l⁻¹", :"kilogram per liter", :"kilograms per liter", :"kilogramme per litre", :"kilogrammes per litre"]
+    unit :"g/l", value: "1 kg/m³", aliases: [:"g·l⁻¹", :"gram per liter", :"grams per liter", :"gramme per litre", :"grammes per litre"]
+    unit :"g/ml", value: "1000 g/l", aliases: [:"g·ml⁻¹", :"gram per milliliter", :"grams per milliliter", :"gramme per millilitre", :"grammes per millilitre"]
+
+    unit :"kg/m³", value: "1000 g/m³", aliases: [:"kg/m^3", :"kg·m⁻³", :"kilogram per cubic meter", :"kilograms per cubic meter", :"kilogramme per cubic metre", :"kilogrammes per cubic metre"]
+    unit :"kg/l", value: "1e+6 g/m³", aliases: [:"kg·l⁻¹", :"kilogram per liter", :"kilograms per liter", :"kilogramme per litre", :"kilogrammes per litre"]
+  end
 end

data/lib/unit_measurements/unit_groups/electric_charge.rb

@@ -0,0 +1,20 @@
+# -*- encoding: utf-8 -*-
+# -*- frozen_string_literal: true -*-
+# -*- warn_indent: true -*-
+
+UnitMeasurements::ElectricCharge = UnitMeasurements.build do
+  system :metric do
+    primitive :C
+
+    si_unit :C, aliases: [:coulomb, :coulombs]
+  end
+
+  system :centimetre_gram_second do
+    primitive :statC
+
+    unit :Fr, value: "3.335641e-10 C", aliases: [:franklin, :franklins]
+    unit :Fd, value: "96485.3377164 C", aliases: [:faraday, :faradays]
+    unit :abC, value: "10 C", aliases: [:abcoulomb, :abcoulombs]
+    unit :statC, value: "3.335641e-10 C", aliases: [:statcoulomb, :statcoulombs]
+  end
+end

data/lib/unit_measurements/unit_groups/electric_current.rb

@@ -3,9 +3,17 @@
 # -*- warn_indent: true -*-
 
 UnitMeasurements::ElectricCurrent = UnitMeasurements.build do
-  si_unit :A, aliases: [:amp, :ampere, :amperes]
+  system :metric do
+    primitive :A
 
-  unit :abA, value: "10 A", aliases: [:abampere, :abamperes]
-  unit :Bi, value: "10 A", aliases: [:biot, :biots]
-  unit :statA, value: "3.33564e-10 A", aliases: [:statampere, :statamperes]
+    si_unit :A, aliases: [:amp, :ampere, :amperes]
+  end
+
+  system :centimetre_gram_second do
+    primitive :abA
+
+    unit :Bi, value: "10 A", aliases: [:biot, :biots]
+    unit :abA, value: "10 A", aliases: [:abampere, :abamperes]
+    unit :statA, value: "3.33564e-10 A", aliases: [:statampere, :statamperes]
+  end
 end

data/lib/unit_measurements/unit_groups/force.rb

@@ -3,12 +3,30 @@
 # -*- warn_indent: true -*-
 
 UnitMeasurements::Force = UnitMeasurements.build do
-  si_unit :N, aliases: [:newton, :newtons] # kg·m·s⁻²
-
-  unit :tf, value: "8896.443230521 N", aliases: [:"tonne-force"]
-  unit :dyn, value: "1e-5 N", aliases: [:dyne, :dynes]
-  unit :kgf, value: "9.80665 N", aliases: [:"kilogram-force", :"kilogramme-force"]
-  unit :ozf, value: "0.27801385095378125 N", aliases: [:"ounce-force"]
-  unit :lbf, value: "4.4482216152605 N", aliases: [:"pound-force"]
-  unit :pdl, value: "0.138254954376 N", aliases: [:poundal, :poundals]
+  system :metric do
+    primitive :N
+
+    si_unit :N, aliases: [:newton, :newtons]
+    unit :kgf, value: "9.80665 N", aliases: [:"kilogram-force", :"kilogramme-force"]
+  end
+
+  system :centimetre_gram_second do
+    unit :dyn, value: "1e-5 N", aliases: [:dyne, :dynes]
+  end
+
+  system :metre_tonne_second do
+    unit :tf, value: "8896.443230521 N", aliases: [:"tonne-force"]
+  end
+
+  system :avoirdupois do
+    unit :ozf, value: "0.27801385095378125 N", aliases: [:"ounce-force"]
+  end
+
+  system :english_engineering do
+    unit :lbf, value: "4.4482216152605 N", aliases: [:"pound-force"]
+  end
+
+  system :foot_pound_second do
+    unit :pdl, value: "0.138254954376 N", aliases: [:poundal, :poundals]
+  end
 end

data/lib/unit_measurements/unit_groups/length.rb

@@ -3,10 +3,18 @@
 # -*- warn_indent: true -*-
 
 UnitMeasurements::Length = UnitMeasurements.build do
-  si_unit :m, aliases: [:meter, :metre, :meters, :metres]
+  system :metric do
+    primitive :m
 
-  unit :in, value: "25.4 mm", aliases: [:'"', :inch, :inches]
-  unit :ft, value: "12 in", aliases: [:"'", :foot, :feet]
-  unit :yd, value: "3 ft", aliases: [:yard, :yards]
-  unit :mi, value: "1760 yd", aliases: [:mile, :miles]
+    si_unit :m, aliases: [:meter, :metre, :meters, :metres]
+  end
+
+  system :imperial do
+    primitive :in
+
+    unit :in, value: "25.4 mm", aliases: [:'"', :inch, :inches]
+    unit :ft, value: "12 in", aliases: [:"'", :foot, :feet]
+    unit :yd, value: "3 ft", aliases: [:yard, :yards]
+    unit :mi, value: "1760 yd", aliases: [:mile, :miles]
+  end
 end

data/lib/unit_measurements/unit_groups/luminous_intensity.rb

@@ -3,7 +3,11 @@
 # -*- warn_indent: true -*-
 
 UnitMeasurements::LuminousIntensity = UnitMeasurements.build do
-  si_unit :cd, aliases: [:candela, :candelas]
+  system :metric do
+    primitive :cd
+
+    si_unit :cd, aliases: [:candela, :candelas]
+  end
 
   unit :hk, value: "0.92 cd", aliases: [:hefnerkerze]
 end

data/lib/unit_measurements/unit_groups/plane_angle.rb

@@ -3,10 +3,14 @@
 # -*- warn_indent: true -*-
 
 UnitMeasurements::PlaneAngle = UnitMeasurements.build do
-  si_unit :rad, aliases: [:radian, :radians]
+  system :metric do
+    primitive :rad
+
+    si_unit :rad, aliases: [:radian, :radians]
+    unit :gon, value: [(Math::PI / 200), :rad], aliases: [:ᵍ, :grad, :gradian, :gradians] # (π / 200) rad
+  end
 
   unit :deg, value: [(Math::PI / 180), :rad], aliases: [:°, :degree, :degrees] # (π / 180) rad
-  unit :gon, value: [(Math::PI / 200), :rad], aliases: [:ᵍ, :grad, :gradian, :gradians] # (π / 200) rad
   unit :cir, value: [360, :deg], aliases: [:circle, :circles] # (2 * π) rad
   unit :mil, value: [Rational(1, 6400), :cir], aliases: [:mils] # ((2 * π) / 6400) rad
   unit :rev, value: [1, :cir], aliases: [:revolution, :revolutions] # (2 * π) rad

data/lib/unit_measurements/unit_groups/solid_angle.rb

@@ -3,7 +3,11 @@
 # -*- warn_indent: true -*-
 
 UnitMeasurements::SolidAngle = UnitMeasurements.build do
-  si_unit :sr, aliases: [:steradian, :steradians]
+  system :metric do
+    primitive :sr
+
+    si_unit :sr, aliases: [:steradian, :steradians]
+  end
 
   unit :sp, value: [(4 * Math::PI), :sr], aliases: [:spat, :spats] # (4 * π) sr
   unit :deg², value: [((Math::PI / 180) ** 2), :sr], aliases: [:"(°)²", :"sq °", :"square degree", :"square degrees"] # (π / 180)² sr

data/lib/unit_measurements/unit_groups/sound_level.rb

@@ -3,7 +3,11 @@
 # -*- warn_indent: true -*-
 
 UnitMeasurements::SoundLevel = UnitMeasurements.build do
-  si_unit :B, aliases: [:bel, :bels]
+  system :metric do
+    primitive :dB
+
+    si_unit :B, aliases: [:bel, :bels]
+  end
 
   unit :Np, value: [(20 / Math.log(10)), :dB], aliases: [:neper, :nepers] # (20 / ln(10)) dB
 end

data/lib/unit_measurements/unit_groups/temperature.rb

@@ -3,7 +3,13 @@
 # -*- warn_indent: true -*-
 
 UnitMeasurements::Temperature = UnitMeasurements.build do
-  si_unit :K, aliases: [:kelvin, :kelvins]
+  system :metric do
+    primitive :K
 
-  unit :°R, value: "5/9 K", aliases: [:R, :°Ra, :Ra, :rankine]
+    si_unit :K, aliases: [:kelvin, :kelvins]
+  end
+
+  system :english_engineering do
+    unit :°R, value: "5/9 K", aliases: [:R, :°Ra, :Ra, :rankine]
+  end
 end

data/lib/unit_measurements/unit_groups/time.rb

@@ -3,7 +3,12 @@
 # -*- warn_indent: true -*-
 
 UnitMeasurements::Time = UnitMeasurements.build do
-  si_unit :s, aliases: [:sec, :second, :seconds]
+  system :metric do
+    primitive :s
+
+    si_unit :s, aliases: [:sec, :second, :seconds]
+    unit :min, value: "60 s", aliases: [:minute, :minutes]
+  end
 
   unit :h, value: "60 min", aliases: [:hr, :hour, :hours]
   unit :d, value: "24 h", aliases: [:day, :days]
@@ -11,7 +16,6 @@ UnitMeasurements::Time = UnitMeasurements.build do
   unit :fn, value: "2 wk", aliases: [:"4tnite", :fortnight, :fortnights]
   unit :mo, value: "30.4167 d", aliases: [:month, :months]
   unit :yr, value: "365 d", aliases: [:y, :year, :years]
-  unit :min, value: "60 s", aliases: [:minute, :minutes]
   unit :qtr, value: "3 mo", aliases: [:quarter, :quarters]
   unit :dec, value: "10 y", aliases: [:decade, :decades]
   unit :cent, value: "10 dec", aliases: [:century, :centuries]

data/lib/unit_measurements/unit_groups/velocity.rb

@@ -3,18 +3,31 @@
 # -*- warn_indent: true -*-
 
 UnitMeasurements::Velocity = UnitMeasurements.build do
-  unit :"m/s", aliases: [:"m·s⁻¹", :"meter per second", :"meters per second", :"metre per second", :"metres per second"]
+  system :metric do
+    primitive :"m/s"
 
-  unit :"m/min", value: "1/60 m/s", aliases: [:"m·min⁻¹", :"meter per minute", :"meters per minute", :"metre per minute", :"metres per minute"]
-  unit :"m/h", value: "1/60 m/min", aliases: [:"m·h⁻¹", :"meter per hour", :"meters per hour", :"metre per hour", :"metres per hour"]
+    unit :"m/s", aliases: [:"m·s⁻¹", :"meter per second", :"meters per second", :"metre per second", :"metres per second"]
+    unit :"m/min", value: "1/60 m/s", aliases: [:"m·min⁻¹", :"meter per minute", :"meters per minute", :"metre per minute", :"metres per minute"]
+    unit :"m/h", value: "1/60 m/min", aliases: [:"m·h⁻¹", :"meter per hour", :"meters per hour", :"metre per hour", :"metres per hour"]
+  end
 
-  unit :"in/s", value: "0.0254 m/s", aliases: [:"in·s⁻¹", :"inch per second", :"inches per second"]
-  unit :"in/min", value: "1/60 in/s", aliases: [:"in·min⁻¹", :"inch per minute", :"inches per minute"]
-  unit :"in/h", value: "1/60 in/min", aliases: [:"in·h⁻¹", :"inch per hour", :"inches per hour"]
+  system :imperial do
+    primitive :"in/s"
 
-  unit :"ft/s", value: "12 in/s", aliases: [:"ft·s⁻¹", :"foot per second", :"feet per second"]
-  unit :"ft/min", value: "1/60 ft/s", aliases: [:"ft·min⁻¹", :"foot per minute", :"feet per minute"]
-  unit :"ft/h", value: "1/60 ft/min", aliases: [:"ft·h⁻¹", :"foot per hour", :"feet per hour"]
+    unit :"in/s", value: "0.0254 m/s", aliases: [:"in·s⁻¹", :"inch per second", :"inches per second"]
+    unit :"in/min", value: "1/60 in/s", aliases: [:"in·min⁻¹", :"inch per minute", :"inches per minute"]
+    unit :"in/h", value: "1/60 in/min", aliases: [:"in·h⁻¹", :"inch per hour", :"inches per hour"]
+  end
 
-  unit :Kn, value: "0.514773 m/s", aliases: [:kt, :knot, :knots]
+  system :foot_pound_second do
+    primitive :"ft/s"
+
+    unit :"ft/s", value: "12 in/s", aliases: [:"ft·s⁻¹", :"foot per second", :"feet per second"]
+    unit :"ft/min", value: "1/60 ft/s", aliases: [:"ft·min⁻¹", :"foot per minute", :"feet per minute"]
+    unit :"ft/h", value: "1/60 ft/min", aliases: [:"ft·h⁻¹", :"foot per hour", :"feet per hour"]
+  end
+
+  system :meteorology_aviation_maritime do
+    unit :Kn, value: "0.514773 m/s", aliases: [:kt, :knot, :knots]
+  end
 end

data/lib/unit_measurements/unit_groups/voltage.rb

@@ -3,11 +3,19 @@
 # -*- warn_indent: true -*-
 
 UnitMeasurements::Voltage = UnitMeasurements.build do
-  si_unit :V, aliases: [:volt, :volts]
+  system :metric do
+    primitive :V
 
-  unit :abV, value: "1e-8 V", aliases: [:abvolt, :abvolts]
-  unit :statV, value: "299.792458 V", aliases: [:statvolt, :statvolts]
+    si_unit :V, aliases: [:volt, :volts]
 
-  unit :"W/A", value: "1 V", aliases: [:"W·A⁻¹", :"watt per ampere", :"watts per ampere"]
-  unit :"J/C", value: "1 V", aliases: [:"J·C⁻¹", :"joule per coulomb", :"joules per coulomb"]
+    unit :"W/A", value: "1 V", aliases: [:"W·A⁻¹", :"watt per ampere", :"watts per ampere"]
+    unit :"J/C", value: "1 V", aliases: [:"J·C⁻¹", :"joule per coulomb", :"joules per coulomb"]
+  end
+
+  system :centimetre_gram_second do
+    primitive :statV
+
+    unit :abV, value: "1e-8 V", aliases: [:abvolt, :abvolts]
+    unit :statV, value: "299.792458 V", aliases: [:statvolt, :statvolts]
+  end
 end

data/lib/unit_measurements/unit_groups/volume.rb

@@ -3,16 +3,24 @@
 # -*- warn_indent: true -*-
 
 UnitMeasurements::Volume = UnitMeasurements.build do
-  si_unit :l, aliases: [:liter, :litre, :liters, :litres]
+  system :metric do
+    primitive :m³
 
-  unit :m³, value: "1000 l", aliases: [:"m^3", :"cu m", :"cubic meter", :"cubic meters", :"cubic metre", :"cubic metres"]
-  unit :mm³, value: "1e-9 m³", aliases: [:"mm^3", :"cu mm", :"cubic millimeter", :"cubic millimeters", :"cubic millimetre", :"cubic millimetres"]
-  unit :cm³, value: "1e-6 m³", aliases: [:"cm^3", :"cu cm", :"cubic centimeter", :"cubic centimeters", :"cubic centimetre", :"cubic centimetres"]
-  unit :dm³, value: "1 l", aliases: [:"dm^3", :"cu dm", :"cubic decimeter", :"cubic decimeters", :"cubic decimetre", :"cubic decimetres"]
-  unit :km³, value: "1e+9 m³", aliases: [:"km^3", :"cu km", :"cubic kilometer", :"cubic kilometers", :"cubic kilometre", :"cubic kilometres"]
+    si_unit :l, aliases: [:liter, :litre, :liters, :litres]
 
-  unit :in³, value: "16.387064 ml", aliases: [:"in^3", :"cu in", :"cubic inch", :"cubic inches"]
-  unit :ft³, value: "1728 in³", aliases: [:"ft^3", :"cu ft", :"cubic foot", :"cubic feet"]
-  unit :yd³, value: "27 ft³", aliases: [:"yd^3", :"cu yd", :"cubic yard", :"cubic yards"]
-  unit :mi³, value: "5451776000 yd³", aliases: [:"mi^3", :"cu mi", :"cubic mile", :"cubic miles"]
+    unit :m³, value: "1000 l", aliases: [:"m^3", :"cu m", :"cubic meter", :"cubic meters", :"cubic metre", :"cubic metres"]
+    unit :mm³, value: "1e-9 m³", aliases: [:"mm^3", :"cu mm", :"cubic millimeter", :"cubic millimeters", :"cubic millimetre", :"cubic millimetres"]
+    unit :cm³, value: "1e-6 m³", aliases: [:"cm^3", :"cu cm", :"cubic centimeter", :"cubic centimeters", :"cubic centimetre", :"cubic centimetres"]
+    unit :dm³, value: "1 l", aliases: [:"dm^3", :"cu dm", :"cubic decimeter", :"cubic decimeters", :"cubic decimetre", :"cubic decimetres"]
+    unit :km³, value: "1e+9 m³", aliases: [:"km^3", :"cu km", :"cubic kilometer", :"cubic kilometers", :"cubic kilometre", :"cubic kilometres"]
+  end
+
+  system :imperial do
+    primitive :in³
+
+    unit :in³, value: "16.387064 ml", aliases: [:"in^3", :"cu in", :"cubic inch", :"cubic inches"]
+    unit :ft³, value: "1728 in³", aliases: [:"ft^3", :"cu ft", :"cubic foot", :"cubic feet"]
+    unit :yd³, value: "27 ft³", aliases: [:"yd^3", :"cu yd", :"cubic yard", :"cubic yards"]
+    unit :mi³, value: "5451776000 yd³", aliases: [:"mi^3", :"cu mi", :"cubic mile", :"cubic miles"]
+  end
 end

data/lib/unit_measurements/unit_groups/weight.rb

@@ -3,8 +3,12 @@
 # -*- warn_indent: true -*-
 
 UnitMeasurements::Weight = UnitMeasurements.build do
-  si_unit :g, aliases: [:gram, :grams, :gramme, :grammes]
+  system :metric do
+    primitive :kg
 
-  unit :q, value: "100 kg", aliases: [:quintal, :quintals]
-  unit :t, value: "10 q", aliases: [:tonne, :tonnes, :"metric tonne", :"metric tonnes"]
+    si_unit :g, aliases: [:gram, :grams, :gramme, :grammes]
+
+    unit :q, value: "100 kg", aliases: [:quintal, :quintals]
+    unit :t, value: "1000 kg", aliases: [:tonne, :tonnes, :"metric tonne", :"metric tonnes"]
+  end
 end

data/lib/unit_measurements/unit_methods.rb

@@ -0,0 +1,45 @@
+# -*- encoding: utf-8 -*-
+# -*- frozen_string_literal: true -*-
+# -*- warn_indent: true -*-
+
+module UnitMeasurements
+  module UnitMethods
+    def unit_for(name)
+      unit_name_to_unit(name)
+    end
+
+    def unit_for!(name)
+      unit = unit_for(name)
+      raise UnitError, name unless unit
+      unit
+    end
+    alias_method :[], :unit_for!
+
+    def unit_with_name_and_aliases
+      units.each_with_object({}) do |unit, hash|
+        unit.names.each { |name| hash[name.to_s] = unit }
+      end
+    end
+
+    def unit_names
+      units.map(&:name).sort
+    end
+
+    def unit_names_with_aliases
+      units.flat_map(&:names).sort
+    end
+
+    def unit_name_to_unit(name)
+      unit_with_name_and_aliases[name.to_s]
+    end
+
+    def defined?(name)
+      unit = unit_for(name)
+      unit ? unit.name == name.to_s : false
+    end
+
+    def unit_or_alias?(name)
+      !!unit_for(name)
+    end
+  end
+end

data/lib/unit_measurements/unit_system.rb

@@ -0,0 +1,29 @@
+# -*- encoding: utf-8 -*-
+# -*- frozen_string_literal: true -*-
+# -*- warn_indent: true -*-
+
+module UnitMeasurements
+  class UnitSystem
+    include UnitMethods
+
+    attr_reader :name, :primitive, :units
+
+    def initialize(name)
+      @name = name
+      @primitive = nil
+      @units = []
+    end
+
+    def add_unit(unit)
+      @units << unit
+    end
+
+    def set_primitive(primitive)
+      @primitive = unit_for!(primitive)
+    end
+
+    def primitive?(unit)
+      @primitive.to_s == (unit.is_a?(Unit) ? unit.name : unit)
+    end
+  end
+end

data/lib/unit_measurements/version.rb

@@ -3,5 +3,5 @@
 # -*- warn_indent: true -*-
 
 module UnitMeasurements
-  VERSION = "3.2.0"
+  VERSION = "3.3.0"
 end

data/units.md

@@ -231,7 +231,26 @@ These units are defined in `UnitMeasurements::Acceleration`.
 | 3 | ft/s² | ft/s^2, ft·s⁻², foot per second squared, feet per second squared |
 | 4 | Kn/s | knot per second, knots per second |
 
-## 19. Angular acceleration
+## 19. Angular velocity
+
+These units are defined in `UnitMeasurements::AngularVelocity`.
+
+| # | Name | Aliases |
+|:--|:--|:--|
+| 1 | rad/s | rad·s⁻¹, radian per second, radians per second |
+| 2 | rad/min | rad·min⁻¹, radian per minute, radians per minute |
+| 3 | rad/h | rad·h⁻¹, radian per hour, radians per hour |
+| 4 | deg/s | °/s, deg·s⁻¹, degree per second, degrees per second |
+| 5 | deg/min | °/min, deg·min⁻¹, degree per minute, degrees per minute |
+| 6 | deg/h | °/h, deg·h⁻¹, degree per hour, degrees per hour |
+| 7 | rev/s | rev·s⁻¹, revolution per second, revolutions per second |
+| 8 | rev/min | rev·min⁻¹, revolution per minute, revolutions per minute |
+| 9 | rev/h | rev·h⁻¹, revolution per hour, revolutions per hour |
+| 10 | gon/s | ᵍ/s, gon·s⁻¹, gradian per second, gradians per second |
+| 11 | gon/min | ᵍ/min, gon·min⁻¹, gradian per minute, gradians per minute |
+| 12 | gon/h | ᵍ/h, gon·h⁻¹, gradian per hour, gradians per hour |
+
+## 20. Angular acceleration
 
 These units are defined in `UnitMeasurements::AngularAcceleration`.
 
@@ -240,3 +259,15 @@ These units are defined in `UnitMeasurements::AngularAcceleration`.
 | 1 | rad/s² | rad/s^2, rad·s⁻², radian per second squared, radians per second squared |
 | 2 | deg/s² | deg/s^2, °/s², deg·s⁻², degree per second squared, degrees per second squared |
 | 3 | gon/s² | gon/s^2, ᵍ/s², gon·s⁻², gradian per second squared, gradians per second squared |
+
+## 21. Electric charge
+
+These units are defined in `UnitMeasurements::ElectricCharge`.
+
+| # | Name | Aliases |
+|:--|:--|:--|
+| 1 | C* | coulomb, coulombs |
+| 2 | abC | abcoulomb, abcoulombs |
+| 3 | statC | statcoulomb, statcoulombs |
+| 4 | Fr | franklin, franklins |
+| 5 | Fd | faraday, faradays |

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: unit_measurements
 version: !ruby/object:Gem::Version
-  version: 3.2.0
+  version: 3.3.0
 platform: ruby
 authors:
 - Harshal LADHE
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2023-09-27 00:00:00.000000000 Z
+date: 2023-09-28 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activesupport
@@ -122,8 +122,10 @@ files:
 - lib/unit_measurements/unit_groups/all.rb
 - lib/unit_measurements/unit_groups/amount_of_substance.rb
 - lib/unit_measurements/unit_groups/angular_acceleration.rb
+- lib/unit_measurements/unit_groups/angular_velocity.rb
 - lib/unit_measurements/unit_groups/area.rb
 - lib/unit_measurements/unit_groups/density.rb
+- lib/unit_measurements/unit_groups/electric_charge.rb
 - lib/unit_measurements/unit_groups/electric_current.rb
 - lib/unit_measurements/unit_groups/force.rb
 - lib/unit_measurements/unit_groups/length.rb
@@ -138,6 +140,8 @@ files:
 - lib/unit_measurements/unit_groups/voltage.rb
 - lib/unit_measurements/unit_groups/volume.rb
 - lib/unit_measurements/unit_groups/weight.rb
+- lib/unit_measurements/unit_methods.rb
+- lib/unit_measurements/unit_system.rb
 - lib/unit_measurements/version.rb
 - unit_measurements.gemspec
 - units.md