Systems documentation added

2025-08-05 05:04:27 +02:00 · 2020-05-14 11:49:01 +02:00
parent a9cd433f3b
commit ec21cfc734
79 changed files with 509 additions and 16 deletions
--- a/docs/CMakeLists.txt
+++ b/docs/CMakeLists.txt
@@ -67,11 +67,14 @@ add_custom_command(OUTPUT "${SPHINX_INDEX_FILE}"
                       "${CMAKE_CURRENT_SOURCE_DIR}/_static/img/downcast_1.png"
                       "${CMAKE_CURRENT_SOURCE_DIR}/_static/img/downcast_2.png"
                       "${CMAKE_CURRENT_SOURCE_DIR}/_static/img/units.png"
+
                       "${CMAKE_CURRENT_SOURCE_DIR}/CHANGELOG.md"
+
                       "${CMAKE_CURRENT_SOURCE_DIR}/design.rst"
                       "${CMAKE_CURRENT_SOURCE_DIR}/design/directories.rst"
                       "${CMAKE_CURRENT_SOURCE_DIR}/design/downcasting.rst"
                       "${CMAKE_CURRENT_SOURCE_DIR}/design/quantity.rst"
+
                       "${CMAKE_CURRENT_SOURCE_DIR}/examples.rst"
                       "${CMAKE_CURRENT_SOURCE_DIR}/examples/avg_speed.rst"
                       "${CMAKE_CURRENT_SOURCE_DIR}/examples/box_example.rst"
@@ -83,7 +86,9 @@ add_custom_command(OUTPUT "${SPHINX_INDEX_FILE}"
                       "${CMAKE_CURRENT_SOURCE_DIR}/examples/linear_algebra.rst"
                       "${CMAKE_CURRENT_SOURCE_DIR}/examples/measurement.rst"
                       "${CMAKE_CURRENT_SOURCE_DIR}/examples/total_energy.rst"
+
                       "${CMAKE_CURRENT_SOURCE_DIR}/faq.rst"
+
                       "${CMAKE_CURRENT_SOURCE_DIR}/framework.rst"
                       "${CMAKE_CURRENT_SOURCE_DIR}/framework/basic_concepts.rst"
                       "${CMAKE_CURRENT_SOURCE_DIR}/framework/constants.rst"
@@ -92,16 +97,108 @@ add_custom_command(OUTPUT "${SPHINX_INDEX_FILE}"
                       "${CMAKE_CURRENT_SOURCE_DIR}/framework/quantities.rst"
                       "${CMAKE_CURRENT_SOURCE_DIR}/framework/text_output.rst"
                       "${CMAKE_CURRENT_SOURCE_DIR}/framework/units.rst"
+
                       "${CMAKE_CURRENT_SOURCE_DIR}/genindex.rst"
                       "${CMAKE_CURRENT_SOURCE_DIR}/glossary.rst"
                       "${CMAKE_CURRENT_SOURCE_DIR}/index.rst"
                       "${CMAKE_CURRENT_SOURCE_DIR}/introduction.rst"
                       "${CMAKE_CURRENT_SOURCE_DIR}/quick_start.rst"
+
                       "${CMAKE_CURRENT_SOURCE_DIR}/reference/concepts.rst"
                       "${CMAKE_CURRENT_SOURCE_DIR}/reference/customization_points.rst"
                       "${CMAKE_CURRENT_SOURCE_DIR}/reference/functions.rst"
                       "${CMAKE_CURRENT_SOURCE_DIR}/reference/metafunctions.rst"
                       "${CMAKE_CURRENT_SOURCE_DIR}/reference/systems.rst"
+
+                       "${CMAKE_CURRENT_SOURCE_DIR}/reference/systems/data.rst"
+                       "${CMAKE_CURRENT_SOURCE_DIR}/reference/systems/data/bitrate.rst"
+                       "${CMAKE_CURRENT_SOURCE_DIR}/reference/systems/data/information.rst"
+                       "${CMAKE_CURRENT_SOURCE_DIR}/reference/systems/data/prefixes.rst"
+
+                       "${CMAKE_CURRENT_SOURCE_DIR}/reference/systems/physical.rst"
+
+                       "${CMAKE_CURRENT_SOURCE_DIR}/reference/systems/physical/cgs.rst"
+                       "${CMAKE_CURRENT_SOURCE_DIR}/reference/systems/physical/cgs/length.rst"
+                       "${CMAKE_CURRENT_SOURCE_DIR}/reference/systems/physical/cgs/acceleration.rst"
+                       "${CMAKE_CURRENT_SOURCE_DIR}/reference/systems/physical/cgs/area.rst"
+                       "${CMAKE_CURRENT_SOURCE_DIR}/reference/systems/physical/cgs/energy.rst"
+                       "${CMAKE_CURRENT_SOURCE_DIR}/reference/systems/physical/cgs/force.rst"
+                       "${CMAKE_CURRENT_SOURCE_DIR}/reference/systems/physical/cgs/length.rst"
+                       "${CMAKE_CURRENT_SOURCE_DIR}/reference/systems/physical/cgs/mass.rst"
+                       "${CMAKE_CURRENT_SOURCE_DIR}/reference/systems/physical/cgs/power.rst"
+                       "${CMAKE_CURRENT_SOURCE_DIR}/reference/systems/physical/cgs/pressure.rst"
+                       "${CMAKE_CURRENT_SOURCE_DIR}/reference/systems/physical/cgs/speed.rst"
+                       "${CMAKE_CURRENT_SOURCE_DIR}/reference/systems/physical/cgs/time.rst"
+
+                       "${CMAKE_CURRENT_SOURCE_DIR}/reference/systems/physical/dimensions_and_concepts.rst"
+
+                       "${CMAKE_CURRENT_SOURCE_DIR}/reference/systems/physical/iau.rst"
+                       "${CMAKE_CURRENT_SOURCE_DIR}/reference/systems/physical/iau/length.rst"
+
+                       "${CMAKE_CURRENT_SOURCE_DIR}/reference/systems/physical/imperial.rst"
+                       "${CMAKE_CURRENT_SOURCE_DIR}/reference/systems/physical/imperial/length.rst"
+
+                       "${CMAKE_CURRENT_SOURCE_DIR}/reference/systems/physical/international.rst"
+                       "${CMAKE_CURRENT_SOURCE_DIR}/reference/systems/physical/international/area.rst"
+                       "${CMAKE_CURRENT_SOURCE_DIR}/reference/systems/physical/international/length.rst"
+                       "${CMAKE_CURRENT_SOURCE_DIR}/reference/systems/physical/international/speed.rst"
+                       "${CMAKE_CURRENT_SOURCE_DIR}/reference/systems/physical/international/volume.rst"
+
+                       "${CMAKE_CURRENT_SOURCE_DIR}/reference/systems/physical/natural.rst"
+                       "${CMAKE_CURRENT_SOURCE_DIR}/reference/systems/physical/natural/constants.rst"
+                       "${CMAKE_CURRENT_SOURCE_DIR}/reference/systems/physical/natural/dimensions.rst"
+                       "${CMAKE_CURRENT_SOURCE_DIR}/reference/systems/physical/natural/units.rst"
+
+                       "${CMAKE_CURRENT_SOURCE_DIR}/reference/systems/physical/si.rst"
+                       "${CMAKE_CURRENT_SOURCE_DIR}/reference/systems/physical/si/absorbed_dose.rst"
+                       "${CMAKE_CURRENT_SOURCE_DIR}/reference/systems/physical/si/acceleration.rst"
+                       "${CMAKE_CURRENT_SOURCE_DIR}/reference/systems/physical/si/area.rst"
+                       "${CMAKE_CURRENT_SOURCE_DIR}/reference/systems/physical/si/capacitance.rst"
+                       "${CMAKE_CURRENT_SOURCE_DIR}/reference/systems/physical/si/catalytic_activity.rst"
+                       "${CMAKE_CURRENT_SOURCE_DIR}/reference/systems/physical/si/charge_density.rst"
+                       "${CMAKE_CURRENT_SOURCE_DIR}/reference/systems/physical/si/concentration.rst"
+                       "${CMAKE_CURRENT_SOURCE_DIR}/reference/systems/physical/si/conductance.rst"
+                       "${CMAKE_CURRENT_SOURCE_DIR}/reference/systems/physical/si/constants.rst"
+                       "${CMAKE_CURRENT_SOURCE_DIR}/reference/systems/physical/si/current_density.rst"
+                       "${CMAKE_CURRENT_SOURCE_DIR}/reference/systems/physical/si/current.rst"
+                       "${CMAKE_CURRENT_SOURCE_DIR}/reference/systems/physical/si/density.rst"
+                       "${CMAKE_CURRENT_SOURCE_DIR}/reference/systems/physical/si/dynamic_viscosity.rst"
+                       "${CMAKE_CURRENT_SOURCE_DIR}/reference/systems/physical/si/electric_charge.rst"
+                       "${CMAKE_CURRENT_SOURCE_DIR}/reference/systems/physical/si/electric_field_strength.rst"
+                       "${CMAKE_CURRENT_SOURCE_DIR}/reference/systems/physical/si/energy.rst"
+                       "${CMAKE_CURRENT_SOURCE_DIR}/reference/systems/physical/si/force.rst"
+                       "${CMAKE_CURRENT_SOURCE_DIR}/reference/systems/physical/si/frequency.rst"
+                       "${CMAKE_CURRENT_SOURCE_DIR}/reference/systems/physical/si/heat_capacity.rst"
+                       "${CMAKE_CURRENT_SOURCE_DIR}/reference/systems/physical/si/inductance.rst"
+                       "${CMAKE_CURRENT_SOURCE_DIR}/reference/systems/physical/si/length.rst"
+                       "${CMAKE_CURRENT_SOURCE_DIR}/reference/systems/physical/si/luminance.rst"
+                       "${CMAKE_CURRENT_SOURCE_DIR}/reference/systems/physical/si/luminous_intensity.rst"
+                       "${CMAKE_CURRENT_SOURCE_DIR}/reference/systems/physical/si/magnetic_flux.rst"
+                       "${CMAKE_CURRENT_SOURCE_DIR}/reference/systems/physical/si/magnetic_induction.rst"
+                       "${CMAKE_CURRENT_SOURCE_DIR}/reference/systems/physical/si/mass.rst"
+                       "${CMAKE_CURRENT_SOURCE_DIR}/reference/systems/physical/si/molar_energy.rst"
+                       "${CMAKE_CURRENT_SOURCE_DIR}/reference/systems/physical/si/momentum.rst"
+                       "${CMAKE_CURRENT_SOURCE_DIR}/reference/systems/physical/si/permeability.rst"
+                       "${CMAKE_CURRENT_SOURCE_DIR}/reference/systems/physical/si/permittivity.rst"
+                       "${CMAKE_CURRENT_SOURCE_DIR}/reference/systems/physical/si/power.rst"
+                       "${CMAKE_CURRENT_SOURCE_DIR}/reference/systems/physical/si/prefixes.rst"
+                       "${CMAKE_CURRENT_SOURCE_DIR}/reference/systems/physical/si/pressure.rst"
+                       "${CMAKE_CURRENT_SOURCE_DIR}/reference/systems/physical/si/resistance.rst"
+                       "${CMAKE_CURRENT_SOURCE_DIR}/reference/systems/physical/si/speed.rst"
+                       "${CMAKE_CURRENT_SOURCE_DIR}/reference/systems/physical/si/substance.rst"
+                       "${CMAKE_CURRENT_SOURCE_DIR}/reference/systems/physical/si/surface_tension.rst"
+                       "${CMAKE_CURRENT_SOURCE_DIR}/reference/systems/physical/si/temperature.rst"
+                       "${CMAKE_CURRENT_SOURCE_DIR}/reference/systems/physical/si/thermal_conductivity.rst"
+                       "${CMAKE_CURRENT_SOURCE_DIR}/reference/systems/physical/si/time.rst"
+                       "${CMAKE_CURRENT_SOURCE_DIR}/reference/systems/physical/si/voltage.rst"
+                       "${CMAKE_CURRENT_SOURCE_DIR}/reference/systems/physical/si/volume.rst"
+
+                       "${CMAKE_CURRENT_SOURCE_DIR}/reference/systems/physical/typographic.rst"
+                       "${CMAKE_CURRENT_SOURCE_DIR}/reference/systems/physical/typographic/length.rst"
+
+                       "${CMAKE_CURRENT_SOURCE_DIR}/reference/systems/physical/us.rst"
+                       "${CMAKE_CURRENT_SOURCE_DIR}/reference/systems/physical/us/length.rst"
+
                       "${CMAKE_CURRENT_SOURCE_DIR}/reference/types.rst"
                       "${CMAKE_CURRENT_SOURCE_DIR}/reference/types/dimensions.rst"
                       "${CMAKE_CURRENT_SOURCE_DIR}/reference/types/prefixes.rst"
@@ -111,6 +208,7 @@ add_custom_command(OUTPUT "${SPHINX_INDEX_FILE}"
                       "${CMAKE_CURRENT_SOURCE_DIR}/reference/types/utilities/basic_fixed_string.rst"
                       "${CMAKE_CURRENT_SOURCE_DIR}/reference/types/utilities/basic_symbol_text.rst"
                       "${CMAKE_CURRENT_SOURCE_DIR}/reference/types/utilities/ratio.rst"
+
                       "${CMAKE_CURRENT_SOURCE_DIR}/use_cases.rst"
                       "${CMAKE_CURRENT_SOURCE_DIR}/use_cases/custom_representation_types.rst"
                       "${CMAKE_CURRENT_SOURCE_DIR}/use_cases/extensions.rst"
@@ -118,6 +216,7 @@ add_custom_command(OUTPUT "${SPHINX_INDEX_FILE}"
                       "${CMAKE_CURRENT_SOURCE_DIR}/use_cases/linear_algebra.rst"
                       "${CMAKE_CURRENT_SOURCE_DIR}/use_cases/natural_units.rst"
                       "${CMAKE_CURRENT_SOURCE_DIR}/use_cases/unknown_dimensions.rst"
+
                       "${CMAKE_CURRENT_SOURCE_DIR}/usage.rst"
                       "${DOXYGEN_INDEX_FILE}"
                   MAIN_DEPENDENCY "${SPHINX_SOURCE}/conf.py"
--- a/docs/reference/systems.rst
+++ b/docs/reference/systems.rst
@@ -1,21 +1,12 @@
-.. note::
-
-  All names defined in this chapter reside in the :any:`units` namespace unless specified otherwise.
-
 Systems
 =======

-SI
--
+.. toctree::
+    :maxdepth: 2

-.. doxygennamespace:: units::physical::si
-    :members:
-    :undoc-members:
-    :outline:
+    systems/physical

+.. toctree::
+    :maxdepth: 1
    
-File
----
-
-.. 
-   doxygenfile:: si/length.h
+    systems/data
--- a/docs/reference/systems/data.rst
+++ b/docs/reference/systems/data.rst
@@ -0,0 +1,9 @@
+Data
+====
+
+.. toctree::
+    :maxdepth: 2
+
+    data/prefixes
+    data/information
+    data/bitrate
--- a/docs/reference/systems/data/bitrate.rst
+++ b/docs/reference/systems/data/bitrate.rst
@@ -0,0 +1,4 @@
+Bitrate
+=======
+
+.. doxygenfile:: data/bitrate.h
--- a/docs/reference/systems/data/information.rst
+++ b/docs/reference/systems/data/information.rst
@@ -0,0 +1,4 @@
+Information
+===========
+
+.. doxygenfile:: data/information.h
--- a/docs/reference/systems/data/prefixes.rst
+++ b/docs/reference/systems/data/prefixes.rst
@@ -0,0 +1,4 @@
+Prefixes
+========
+
+.. doxygenfile:: data/prefixes.h
--- a/docs/reference/systems/physical.rst
+++ b/docs/reference/systems/physical.rst
@@ -0,0 +1,15 @@
+Physical
+========
+
+.. toctree::
+    :maxdepth: 2
+
+    dimensions_and_concepts
+    physical/si
+    physical/cgs
+    physical/international
+    physical/us
+    physical/imperial
+    physical/iau
+    physical/typographic
+    physical/natural
--- a/docs/reference/systems/physical/cgs.rst
+++ b/docs/reference/systems/physical/cgs.rst
@@ -0,0 +1,16 @@
+CGS
+===
+
+.. toctree::
+    :maxdepth: 2
+
+    cgs/acceleration
+    cgs/area
+    cgs/energy
+    cgs/force
+    cgs/length
+    cgs/mass
+    cgs/power
+    cgs/pressure
+    cgs/speed
+    cgs/time
--- a/docs/reference/systems/physical/cgs/acceleration.rst
+++ b/docs/reference/systems/physical/cgs/acceleration.rst
@@ -0,0 +1,4 @@
+Acceleration
+============
+
+.. doxygenfile:: cgs/acceleration.h
--- a/docs/reference/systems/physical/cgs/area.rst
+++ b/docs/reference/systems/physical/cgs/area.rst
@@ -0,0 +1,4 @@
+Area
+====
+
+.. doxygenfile:: cgs/area.h
--- a/docs/reference/systems/physical/cgs/energy.rst
+++ b/docs/reference/systems/physical/cgs/energy.rst
@@ -0,0 +1,4 @@
+Energy
+======
+
+.. doxygenfile:: cgs/energy.h
--- a/docs/reference/systems/physical/cgs/force.rst
+++ b/docs/reference/systems/physical/cgs/force.rst
@@ -0,0 +1,4 @@
+Force
+=====
+
+.. doxygenfile:: cgs/force.h
--- a/docs/reference/systems/physical/cgs/length.rst
+++ b/docs/reference/systems/physical/cgs/length.rst
@@ -0,0 +1,4 @@
+Length
+======
+
+.. doxygenfile:: cgs/length.h
--- a/docs/reference/systems/physical/cgs/mass.rst
+++ b/docs/reference/systems/physical/cgs/mass.rst
@@ -0,0 +1,4 @@
+Mass
+====
+
+.. doxygenfile:: cgs/mass.h
--- a/docs/reference/systems/physical/cgs/power.rst
+++ b/docs/reference/systems/physical/cgs/power.rst
@@ -0,0 +1,4 @@
+Power
+=====
+
+.. doxygenfile:: cgs/power.h
--- a/docs/reference/systems/physical/cgs/pressure.rst
+++ b/docs/reference/systems/physical/cgs/pressure.rst
@@ -0,0 +1,4 @@
+Pressure
+========
+
+.. doxygenfile:: cgs/pressure.h
--- a/docs/reference/systems/physical/cgs/speed.rst
+++ b/docs/reference/systems/physical/cgs/speed.rst
@@ -0,0 +1,4 @@
+Speed
+=====
+
+.. doxygenfile:: cgs/speed.h
--- a/docs/reference/systems/physical/cgs/time.rst
+++ b/docs/reference/systems/physical/cgs/time.rst
@@ -0,0 +1,4 @@
+Time
+====
+
+.. doxygenfile:: cgs/time.h
--- a/docs/reference/systems/physical/dimensions_and_concepts.rst
+++ b/docs/reference/systems/physical/dimensions_and_concepts.rst
@@ -0,0 +1,4 @@
+Dimensions and Concepts
+=======================
+
+.. doxygenfile:: dimensions.h
--- a/docs/reference/systems/physical/iau.rst
+++ b/docs/reference/systems/physical/iau.rst
@@ -0,0 +1,7 @@
+IAU
+===
+
+.. toctree::
+    :maxdepth: 2
+
+    iau/length
--- a/docs/reference/systems/physical/iau/length.rst
+++ b/docs/reference/systems/physical/iau/length.rst
@@ -0,0 +1,4 @@
+Length
+======
+
+.. doxygenfile:: iau/length.h
--- a/docs/reference/systems/physical/imperial.rst
+++ b/docs/reference/systems/physical/imperial.rst
@@ -0,0 +1,7 @@
+Imperial
+========
+
+.. toctree::
+    :maxdepth: 2
+
+    imperial/length
--- a/docs/reference/systems/physical/imperial/length.rst
+++ b/docs/reference/systems/physical/imperial/length.rst
@@ -0,0 +1,4 @@
+Length
+======
+
+.. doxygenfile:: imperial/length.h
--- a/docs/reference/systems/physical/international.rst
+++ b/docs/reference/systems/physical/international.rst
@@ -0,0 +1,10 @@
+International
+=============
+
+.. toctree::
+    :maxdepth: 2
+
+    international/area
+    international/length
+    international/speed
+    international/volume
--- a/docs/reference/systems/physical/international/area.rst
+++ b/docs/reference/systems/physical/international/area.rst
@@ -0,0 +1,4 @@
+Area
+====
+
+.. doxygenfile:: international/area.h
--- a/docs/reference/systems/physical/international/length.rst
+++ b/docs/reference/systems/physical/international/length.rst
@@ -0,0 +1,4 @@
+Length
+======
+
+.. doxygenfile:: international/length.h
--- a/docs/reference/systems/physical/international/speed.rst
+++ b/docs/reference/systems/physical/international/speed.rst
@@ -0,0 +1,4 @@
+Speed
+=====
+
+.. doxygenfile:: speed/length.h
--- a/docs/reference/systems/physical/international/volume.rst
+++ b/docs/reference/systems/physical/international/volume.rst
@@ -0,0 +1,4 @@
+Volume
+======
+
+.. doxygenfile:: international/volume.h
--- a/docs/reference/systems/physical/natural.rst
+++ b/docs/reference/systems/physical/natural.rst
@@ -0,0 +1,9 @@
+Natural
+=======
+
+.. toctree::
+    :maxdepth: 2
+
+    natural/dimensions
+    natural/units
+    natural/constants
--- a/docs/reference/systems/physical/natural/constants.rst
+++ b/docs/reference/systems/physical/natural/constants.rst
@@ -0,0 +1,4 @@
+Constants
+=========
+
+.. doxygenfile:: natural/constants.h
--- a/docs/reference/systems/physical/natural/dimensions.rst
+++ b/docs/reference/systems/physical/natural/dimensions.rst
@@ -0,0 +1,4 @@
+Dimensions
+==========
+
+.. doxygenfile:: natural/dimensions.h
--- a/docs/reference/systems/physical/natural/units.rst
+++ b/docs/reference/systems/physical/natural/units.rst
@@ -0,0 +1,4 @@
+Units
+=====
+
+.. doxygenfile:: natural/units.h
--- a/docs/reference/systems/physical/si.rst
+++ b/docs/reference/systems/physical/si.rst
@@ -0,0 +1,48 @@
+SI
+==
+
+.. toctree::
+    :maxdepth: 2
+
+    si/prefixes
+    si/constants
+    si/absorbed_dose
+    si/acceleration
+    si/area
+    si/capacitance
+    si/catalytic_activity
+    si/charge_density
+    si/concentration
+    si/conductance
+    si/current_density
+    si/current
+    si/density
+    si/dynamic_viscosity
+    si/electric_charge
+    si/electric_field_strength
+    si/energy
+    si/force
+    si/frequency
+    si/heat_capacity
+    si/inductance
+    si/length
+    si/luminance
+    si/luminous_intensity
+    si/magnetic_flux
+    si/magnetic_induction
+    si/mass
+    si/molar_energy
+    si/momentum
+    si/permeability
+    si/permittivity
+    si/power
+    si/pressure
+    si/resistance
+    si/speed
+    si/substance
+    si/surface_tension
+    si/temperature
+    si/thermal_conductivity
+    si/time
+    si/voltage
+    si/volume
--- a/docs/reference/systems/physical/si/absorbed_dose.rst
+++ b/docs/reference/systems/physical/si/absorbed_dose.rst
@@ -0,0 +1,4 @@
+Absorbed Dose
+=============
+
+.. doxygenfile:: si/absorbed_dose.h
--- a/docs/reference/systems/physical/si/acceleration.rst
+++ b/docs/reference/systems/physical/si/acceleration.rst
@@ -0,0 +1,4 @@
+Acceleration
+============
+
+.. doxygenfile:: si/acceleration.h
--- a/docs/reference/systems/physical/si/area.rst
+++ b/docs/reference/systems/physical/si/area.rst
@@ -0,0 +1,4 @@
+Area
+====
+
+.. doxygenfile:: si/area.h
--- a/docs/reference/systems/physical/si/capacitance.rst
+++ b/docs/reference/systems/physical/si/capacitance.rst
@@ -0,0 +1,4 @@
+Capacitance
+===========
+
+.. doxygenfile:: si/capacitance.h
--- a/docs/reference/systems/physical/si/catalytic_activity.rst
+++ b/docs/reference/systems/physical/si/catalytic_activity.rst
@@ -0,0 +1,4 @@
+Catalytic Activity
+==================
+
+.. doxygenfile:: si/catalytic_activity.h
--- a/docs/reference/systems/physical/si/charge_density.rst
+++ b/docs/reference/systems/physical/si/charge_density.rst
@@ -0,0 +1,4 @@
+Charge Density
+==============
+
+.. doxygenfile:: si/charge_density.h
--- a/docs/reference/systems/physical/si/concentration.rst
+++ b/docs/reference/systems/physical/si/concentration.rst
@@ -0,0 +1,4 @@
+Concentration
+=============
+
+.. doxygenfile:: si/conductance.h
--- a/docs/reference/systems/physical/si/conductance.rst
+++ b/docs/reference/systems/physical/si/conductance.rst
@@ -0,0 +1,4 @@
+Conductance
+===========
+
+.. doxygenfile:: si/conductance.h
--- a/docs/reference/systems/physical/si/constants.rst
+++ b/docs/reference/systems/physical/si/constants.rst
@@ -0,0 +1,4 @@
+Constants
+=========
+
+.. doxygenfile:: si/constants.h
--- a/docs/reference/systems/physical/si/current.rst
+++ b/docs/reference/systems/physical/si/current.rst
@@ -0,0 +1,4 @@
+Current
+=======
+
+.. doxygenfile:: si/current.h
--- a/docs/reference/systems/physical/si/current_density.rst
+++ b/docs/reference/systems/physical/si/current_density.rst
@@ -0,0 +1,4 @@
+Current density
+===============
+
+.. doxygenfile:: si/current_density.h
--- a/docs/reference/systems/physical/si/density.rst
+++ b/docs/reference/systems/physical/si/density.rst
@@ -0,0 +1,4 @@
+Density
+=======
+
+.. doxygenfile:: si/density.h
--- a/docs/reference/systems/physical/si/dynamic_viscosity.rst
+++ b/docs/reference/systems/physical/si/dynamic_viscosity.rst
@@ -0,0 +1,4 @@
+Dynamic Viscosity
+=================
+
+.. doxygenfile:: si/dynamic_viscosity.h
--- a/docs/reference/systems/physical/si/electric_charge.rst
+++ b/docs/reference/systems/physical/si/electric_charge.rst
@@ -0,0 +1,4 @@
+Electric Charge
+===============
+
+.. doxygenfile:: si/electric_charge.h
--- a/docs/reference/systems/physical/si/electric_field_strength.rst
+++ b/docs/reference/systems/physical/si/electric_field_strength.rst
@@ -0,0 +1,4 @@
+Electric Field Strength
+=======================
+
+.. doxygenfile:: si/electric_field_strength.h
--- a/docs/reference/systems/physical/si/energy.rst
+++ b/docs/reference/systems/physical/si/energy.rst
@@ -0,0 +1,4 @@
+Energy
+======
+
+.. doxygenfile:: si/energy.h
--- a/docs/reference/systems/physical/si/force.rst
+++ b/docs/reference/systems/physical/si/force.rst
@@ -0,0 +1,4 @@
+Force
+=====
+
+.. doxygenfile:: si/force.h
--- a/docs/reference/systems/physical/si/frequency.rst
+++ b/docs/reference/systems/physical/si/frequency.rst
@@ -0,0 +1,4 @@
+Frequency
+=========
+
+.. doxygenfile:: si/frequency.h
--- a/docs/reference/systems/physical/si/heat_capacity.rst
+++ b/docs/reference/systems/physical/si/heat_capacity.rst
@@ -0,0 +1,4 @@
+Heat Capacity
+=============
+
+.. doxygenfile:: si/heat_capacity.h
--- a/docs/reference/systems/physical/si/inductance.rst
+++ b/docs/reference/systems/physical/si/inductance.rst
@@ -0,0 +1,4 @@
+Inductance
+==========
+
+.. doxygenfile:: si/inductance.h
--- a/docs/reference/systems/physical/si/length.rst
+++ b/docs/reference/systems/physical/si/length.rst
@@ -0,0 +1,4 @@
+Length
+======
+
+.. doxygenfile:: si/length.h
--- a/docs/reference/systems/physical/si/luminance.rst
+++ b/docs/reference/systems/physical/si/luminance.rst
@@ -0,0 +1,4 @@
+Luminance
+=========
+
+.. doxygenfile:: si/luminance.h
--- a/docs/reference/systems/physical/si/luminous_intensity.rst
+++ b/docs/reference/systems/physical/si/luminous_intensity.rst
@@ -0,0 +1,4 @@
+Luminous Intensity
+==================
+
+.. doxygenfile:: si/luminous_intensity.h
--- a/docs/reference/systems/physical/si/magnetic_flux.rst
+++ b/docs/reference/systems/physical/si/magnetic_flux.rst
@@ -0,0 +1,4 @@
+Magnetic Flux
+=============
+
+.. doxygenfile:: si/magnetic_flux.h
--- a/docs/reference/systems/physical/si/magnetic_induction.rst
+++ b/docs/reference/systems/physical/si/magnetic_induction.rst
@@ -0,0 +1,4 @@
+Magnetic Induction
+==================
+
+.. doxygenfile:: si/magnetic_induction.h
--- a/docs/reference/systems/physical/si/mass.rst
+++ b/docs/reference/systems/physical/si/mass.rst
@@ -0,0 +1,4 @@
+Mass
+====
+
+.. doxygenfile:: si/mass.h
--- a/docs/reference/systems/physical/si/molar_energy.rst
+++ b/docs/reference/systems/physical/si/molar_energy.rst
@@ -0,0 +1,4 @@
+Molar Energy
+============
+
+.. doxygenfile:: si/molar_energy.h
--- a/docs/reference/systems/physical/si/momentum.rst
+++ b/docs/reference/systems/physical/si/momentum.rst
@@ -0,0 +1,4 @@
+Momentum
+========
+
+.. doxygenfile:: si/momentum.h
--- a/docs/reference/systems/physical/si/permeability.rst
+++ b/docs/reference/systems/physical/si/permeability.rst
@@ -0,0 +1,4 @@
+Permeability
+============
+
+.. doxygenfile:: si/permeability.h
--- a/docs/reference/systems/physical/si/permittivity.rst
+++ b/docs/reference/systems/physical/si/permittivity.rst
@@ -0,0 +1,4 @@
+Permittivity
+============
+
+.. doxygenfile:: si/permittivity.h
--- a/docs/reference/systems/physical/si/power.rst
+++ b/docs/reference/systems/physical/si/power.rst
@@ -0,0 +1,4 @@
+Power
+=====
+
+.. doxygenfile:: si/power.h
--- a/docs/reference/systems/physical/si/prefixes.rst
+++ b/docs/reference/systems/physical/si/prefixes.rst
@@ -0,0 +1,4 @@
+Prefixes
+========
+
+.. doxygenfile:: si/prefixes.h
--- a/docs/reference/systems/physical/si/pressure.rst
+++ b/docs/reference/systems/physical/si/pressure.rst
@@ -0,0 +1,4 @@
+Pressure
+========
+
+.. doxygenfile:: si/pressure.h
--- a/docs/reference/systems/physical/si/resistance.rst
+++ b/docs/reference/systems/physical/si/resistance.rst
@@ -0,0 +1,4 @@
+Resistance
+==========
+
+.. doxygenfile:: si/resistance.h
--- a/docs/reference/systems/physical/si/speed.rst
+++ b/docs/reference/systems/physical/si/speed.rst
@@ -0,0 +1,4 @@
+Speed
+=====
+
+.. doxygenfile:: si/speed.h
--- a/docs/reference/systems/physical/si/substance.rst
+++ b/docs/reference/systems/physical/si/substance.rst
@@ -0,0 +1,4 @@
+Substance
+=========
+
+.. doxygenfile:: si/substance.h
--- a/docs/reference/systems/physical/si/surface_tension.rst
+++ b/docs/reference/systems/physical/si/surface_tension.rst
@@ -0,0 +1,4 @@
+Surface Tension
+===============
+
+.. doxygenfile:: si/surface_tension.h
--- a/docs/reference/systems/physical/si/temperature.rst
+++ b/docs/reference/systems/physical/si/temperature.rst
@@ -0,0 +1,4 @@
+Temperature
+===========
+
+.. doxygenfile:: si/temperature.h
--- a/docs/reference/systems/physical/si/thermal_conductivity.rst
+++ b/docs/reference/systems/physical/si/thermal_conductivity.rst
@@ -0,0 +1,4 @@
+Thermal Conductivity
+====================
+
+.. doxygenfile:: si/thermal_conductivity.h
--- a/docs/reference/systems/physical/si/time.rst
+++ b/docs/reference/systems/physical/si/time.rst
@@ -0,0 +1,4 @@
+Time
+====
+
+.. doxygenfile:: si/time.h
--- a/docs/reference/systems/physical/si/voltage.rst
+++ b/docs/reference/systems/physical/si/voltage.rst
@@ -0,0 +1,4 @@
+Voltage
+=======
+
+.. doxygenfile:: si/voltage.h
--- a/docs/reference/systems/physical/si/volume.rst
+++ b/docs/reference/systems/physical/si/volume.rst
@@ -0,0 +1,4 @@
+Volume
+======
+
+.. doxygenfile:: si/volume.h
--- a/docs/reference/systems/physical/typographic.rst
+++ b/docs/reference/systems/physical/typographic.rst
@@ -0,0 +1,7 @@
+Typographic
+===========
+
+.. toctree::
+    :maxdepth: 2
+
+    typographic/length
--- a/docs/reference/systems/physical/typographic/length.rst
+++ b/docs/reference/systems/physical/typographic/length.rst
@@ -0,0 +1,4 @@
+Length
+======
+
+.. doxygenfile:: typographic/length.h
--- a/docs/reference/systems/physical/us.rst
+++ b/docs/reference/systems/physical/us.rst
@@ -0,0 +1,7 @@
+US
+==
+
+.. toctree::
+    :maxdepth: 2
+
+    us/length
--- a/docs/reference/systems/physical/us/length.rst
+++ b/docs/reference/systems/physical/us/length.rst
@@ -0,0 +1,4 @@
+Length
+======
+
+.. doxygenfile:: us/length.h