WIP: Update Recommended values documents

README.adoc

@@ -47,6 +47,17 @@ The composite bilingual SI Brochure is compiled as a Metanorma
 collection which includes all its components as individual
 documents.
 
+== Structure
+
+`sources/si-brochure/`:: source files for the SI Brochure and its components.
+
+`sources/si-brochure/1.08`:: source files for the SI Brochure edition 9 v1.08, published 2020-09-17.
+
+`sources/si-brochure/2.01`:: source files for the SI Brochure edition 9 v2.01, published 2019-05-20.
+
+`sources/si-brochure/3.01`:: source files for the SI Brochure edition 9 v3.01.
+
+
 
 == Fetching the document
 

metanorma.yml

@@ -9,13 +9,17 @@ metanorma:
     - sources/rec-values/mep-wgfs-nm778-Rb/2005/document.adoc
     - sources/rec-values/mep-wgfs-nm698-87Sr_429THz/2019/document.adoc
     - sources/rec-values/mep-wgfs-nm237-115In_1267THz/2017/document.adoc
-    - sources/rec-values/mep-wgfs-nm436-171Yb_688THz/2019/document.adoc
+    - sources/rec-values/mep-wgfs-nm237-115In_1267THz/2021/document.adoc
+    - sources/rec-values/mep-wgfs-nm436-171Yb_688THz/2015/document.adoc
+    - sources/rec-values/mep-wgfs-nm436-171Yb_688THz/2021/document.adoc
     - sources/rec-values/mep-wgfs-nm606-Kr/2003/document.adoc
-    - sources/rec-values/mep-wgfs-nm266-199Hg_1129THz/2019/document.adoc
+    - sources/rec-values/mep-wgfs-nm266-199Hg_1129THz/2017/document.adoc
+    - sources/rec-values/mep-wgfs-nm266-199Hg_1129THz/2021/document.adoc
     - sources/rec-values/mep-wgfs-cm4_4-Rb_6-835GHz/2019/document.adoc
     - sources/rec-values/mep-wgfs-nm467-171Yb_642THz/2019/document.adoc
-    - sources/rec-values/mep-wgfs-nm531-I2/2019/document.adoc
-    - sources/rec-values/mep-wgfs-nm515-I2/2005/document.adoc
+    - sources/rec-values/mep-wgfs-nm467-171Yb_642THz/2021/document.adoc
+    - sources/rec-values/mep-wgfs-nm531-I2/2015/document.adoc
+    - sources/rec-values/mep-wgfs-nm515-I2/2015/document.adoc
     - sources/rec-values/mep-wgfs-nm780-Rb/2019/document.adoc
     - sources/rec-values/mep-wgfs-nm612-I2/2003/document.adoc
     - sources/rec-values/mep-wgfs-nm633-I2/2003/document.adoc
@@ -24,14 +28,16 @@ metanorma:
     - sources/rec-values/mep-wgfs-nm576-I2/2003/document.adoc
     - sources/rec-values/mep-wgfs-nm543-I2/2003/document.adoc
     - sources/rec-values/mep-wgfs-nm532-I2/2019/document.adoc
-    - sources/rec-values/mep-wgfs-nm243-H_1233THz/2019/document.adoc
+    - sources/rec-values/mep-wgfs-nm243-H_1233THz/2015/document.adoc
     - sources/rec-values/mep-wgfs-um10_3-OsO4/2003/document.adoc
     - sources/rec-values/mep-wgfs-nm640-I2/2003/document.adoc
-    - sources/rec-values/mep-wgfs-nm267-27Al_1121THz/2019/document.adoc
+    - sources/rec-values/mep-wgfs-nm267-27Al_1121THz/2013/document.adoc
+    - sources/rec-values/mep-wgfs-nm267-27Al_1121THz/2021/document.adoc
     - sources/rec-values/mep-wgfs-nm657-Ca/2005/document.adoc
     - sources/rec-values/mep-wgfs-nm674-88Sr_445THz/2019/document.adoc
     - sources/rec-values/mep-wgfs-nm698-88Sr_429THz/2019/document.adoc
-    - sources/rec-values/mep-wgfs-nm282-199Hg_1065THz/2019/document.adoc
+    - sources/rec-values/mep-wgfs-nm282-199Hg_1065THz/2013/document.adoc
+    - sources/rec-values/mep-wgfs-nm282-199Hg_1065THz/2021/document.adoc
 
     - sources/guide-ccem-ampere-realization-en.adoc
     - sources/guide-ccl-metre-realization-1-en.adoc
@@ -45,6 +51,8 @@ metanorma:
     - sources/mep-kelvin-absolute-en.adoc
     - sources/mep-kelvin-absolute-uncertainty-en.adoc
     - sources/mep-kelvin-definition-en.adoc
+
+    # Tested up to here
     - sources/mep-kelvin-lt-johnson-noise-en.adoc
     - sources/mep-kelvin-relative-en.adoc
     - sources/mep-kilogram-definition-en.adoc
@@ -55,8 +63,8 @@ metanorma:
     - sources/sib-a4-en.adoc
     - sources/sib-a4-fr.adoc
 
-    # The SI Brochure collection
-    # - sources/si-brochure/1.08/collection.yml
+    # # The SI Brochure collection
+    # # - sources/si-brochure/1.08/collection.yml
     - sources/si-brochure/2.01/collection.yml
 
   collection:

reference-docs/rec-values/README.adoc

@@ -0,0 +1,3 @@
+Files available in this directory were downloaded from
+https://www.bipm.org/en/publications/mises-en-pratique/standard-frequencies?version=1.4&t=1637238077933&download=true
+on 19th October 2022.

sources/rec-values/mep-wgfs-nm237-115In_1267THz/2021/document.adoc

@@ -0,0 +1,92 @@
+= Recommended Values of Standard Frequencies: Indium 115 Ion (stem:[f ~~ 1267 "unitsml(THz)"])
+:appendix-id: 2
+:partnumber: 2.1
+:edition: 9
+:copyright-year: 2019
+:language: en
+:docnumber: SI MEP M REC 1267THz
+:title-appendix-en: Recommended values of standard frequencies for applications including the practical realization of the metre and secondary representations of the second
+:title-appendix-fr: Valeurs recommandées des fréquences étalons destinées à la mise en pratique de la définition du mètre et aux représentations secondaires de la seconde
+:title-part-en: Indium 115 Ion (stem:[f ~~ 1267 "unitsml(THz)"])
+:title-part-fr: Indium 115 Ion (stem:[f ~~ 1267 "unitsml(THz)"])
+:title-en: The International System of Units
+:title-fr: Le système international d'unités
+:doctype: mise-en-pratique
+:committee-acronym: CCL-CCTF-WGFS
+:committee-en: CCL-CCTF Frequency Standards Working Group
+:si-aspect: m_c_deltanu
+:docstage: in-force
+:confirmed-date: 2021-03
+:revdate: 2022-04-13
+:imagesdir: images
+:mn-document-class: bipm
+:mn-output-extensions: xml,html,pdf,rxl
+:local-cache-only:
+:data-uri-image:
+
+[%unnumbered]
+== {blank}
+
+stem:["‌"^{115} "In"^"+"], stem:[5"s"^2 " "^1"S"_0 - 5"s" 5"p"" "^3"P"_0]
+*unperturbed optical transition*
+
+== Recommended value <<cctf>> of the frequency in the CIPM List of Frequencies
+
+stem:[f ("&#x200c;"^{115} "In"^"+") = 1267402452901041.3 "unitsml(Hz)"]
+
+equivalent to
+
+stem:[ii(lambda) ("&#x200c;"^{115} "In"^"+") = 236540853.5495455 "unitsml(fm)"],
+
+with a relative standard uncertainty of stem:[4.3 xx 10^(-15)].
+
+== Method to establish the recommended value
+
+A global adjustment of all measurements of frequency ratios published in
+peer-reviewed publications and available to the CCL-CCTF WGFS was carried out
+following the methods presented in <<from!margolis;to!riehle>>.
+
+This adjustment determines the frequency of 14 transitions (see <<fig1>>) which are
+either already adopted as secondary representations of the second <<riehle>> or
+considered as candidates for SRS. It took into account 105 measurements, including 33
+frequency ratios and 72 absolute frequency measurements (i.e. ratios to the
+stem:["&#x200c;"^{133} "Cs"] frequency). A total of 483 correlations between these
+input measurements were estimated and considered in the adjustment. More details on
+the input data and the processing are provided at
+https://webtai.bipm.org/ftp/pub/tai/publication/wgfs/Adjustment_2021.html . The
+recommended value is the direct result of the adjustment, rounded as deemed adequate
+with respect to the recommended uncertainty.
+
+While the results are from a global adjustment, it is of interest to note (see
+<<fig1>>) that the stem:["&#x200c;"^{115} "In"^"+"] transition is involved in 4
+measurements relative to stem:["&#x200c;"^{133} "Cs"], and in 1 frequency ratio with
+an optical transition.
+
+[[fig1]]
+.Representation of the 105 measurements linking 14 transitions on the circle and stem:["&#x200c;"^{133} "Cs"] at the center.
+image::fig-01.jpg[]
+
+[bibliography]
+== References
+
+* [[[cctf,(1)CCTF Meeting 22]]], Consultative Committee for Time and Frequency
+(CCTF), 22nd meeting (session II -- online), Recommendation PSFS-2 available at
+https://www.bipm.org/en/committees/cc/cctf/22-_2-2021
+
+* [[[margolis,(2)BIPM Metrologia 52 5 628]]], H. S. Margolis, P. Gill: Least-squares
+analysis of clock frequency comparison data to deduce optimized frequency and
+frequency ratio values; _Metrologia_ *52*, 628 (2015)
+
+* [[[robertsson, (3)BIPM Metrologia 53 6 1272]]], L. Robertsson: On the evaluation of
+ultra-high-precision frequency ratio measurements: examining closed loops in a graph
+theory framework; _Metrologia_ *53*, 1272 (2016)
+
+* [[[panfilo, 4]]], G. Panfilo, communication to the CCL-CCTF WGFS. A new
+implementation of [4] was realized in MatLab at the BIPM (2020)
+
+* [[[oates,5]]], Ch. Oates, communication to the CCL-CCTF WGFS. An independent
+program was developed in Mathematica at NIST (2017)
+
+* [[[riehle,(6)BIPM Metrologia 55 2 188]]], F. Riehle, P. Gill, F. Arias, L.
+Robertsson: The CIPM List of Recommended Frequency Standard Values: Guidelines and
+Procedures; _Metrologia_ *55*, 188 -- 200 (2018)

sources/rec-values/mep-wgfs-nm243-H_1233THz/2019/document.adoc → sources/rec-values/mep-wgfs-nm243-H_1233THz/2015/document.adoc

@@ -1,4 +1,4 @@
-= Recommended Values of Standard Frequencies: Hydrogen stem:[""^1 H] Atom (stem:[f ~~ 1233 "unitsml(THz)"])
+= Recommended Values of Standard Frequencies: Hydrogen stem:[""^{1} "H"] Atom (stem:[f ~~ 1233 "unitsml(THz)"])
 :appendix-id: 2
 :partnumber: 2.2
 :edition: 9
@@ -7,15 +7,15 @@
 :docnumber: SI MEP M REC 1233THz
 :title-appendix-en: Recommended values of standard frequencies for applications including the practical realization of the metre and secondary representations of the second
 :title-appendix-fr: Valeurs recommandées des fréquences étalons destinées à la mise en pratique de la définition du mètre et aux représentations secondaires de la seconde
-:title-part-en: Hydrogen stem:[""^1 H] Atom (stem:[f ~~ 1233 "unitsml(THz)"])
-:title-part-fr: Hydrogen stem:[""^1 H] Atom (stem:[f ~~ 1233 "unitsml(THz)"])
+:title-part-en: Hydrogen stem:[""^{1} "H"] Atom (stem:[f ~~ 1233 "unitsml(THz)"])
+:title-part-fr: Hydrogen stem:[""^{1} "H"] Atom (stem:[f ~~ 1233 "unitsml(THz)"])
 :title-en: The International System of Units
-:title-fr: Le système international d’unités
+:title-fr: Le système international d'unités
 :doctype: mise-en-pratique
 :committee-acronym: CCL-CCTF-WGFS
 :committee-en: CCL-CCTF Frequency Standards Working Group
 :si-aspect: m_c_deltanu
-:status: in-force
+:docstage: in-force
 :confirmed-date: 2015-10
 :revdate: 2016-05
 :imagesdir: images
@@ -27,31 +27,32 @@
 [%unnumbered]
 == {blank}
 
-*^1^H neutral atom, stem:[rm(1S - 2S)] unperturbed optical transition*
+*stem:["‌"^{1} "H"] neutral atom, stem:[1S - 2S] unperturbed optical transition*
 
 == Recommended value <<cipm-rec2>> of the frequency
 
-stem:[f (""^1 "H") = 1233030706593514 "unitsml(Hz)"]
+stem:[f ("&#x200c;"^{1} "H") = 1233030706593514 "unitsml(Hz)"]
 
 equivalent to
 
-stem:[ii(lambda) (""^1 "H") = 243134624.626044 "unitsml(fm)"],
+stem:[ii(lambda) ("&#x200c;"^{1} "H") = 243134624.626044 "unitsml(fm)"],
 
 with an estimated relative standard uncertainty of stem:[9 xx 10^(-15)].
 
-NOTE: The stem:[rm(1S - 2S)] transition is excited by two photons of the frequency stem:[1233 "unitsml(THz)"]
+NOTE: The stem:[1S - 2S] transition is excited by two photons of the frequency
+stem:[1233 "unitsml(THz)"]
 
 == Source data
 
-Adopted value:: stem:[f (""^1 "H") = 1233030706593514 "unitsml(Hz)"] +
+Adopted value:: stem:[f ("&#x200c;"^{1} "H") = 1233030706593514 "unitsml(Hz)"] +
 stem:[u_c//y = 9 xx 10^(-15)]
 
 calculated from
 
 [cols="<,^,^"]
 [%unnumbered]
 |===
-h| stem:[2 xx f(""^1 "H") // "unitsml(Hz)"] h| stem:[u // "unitsml(Hz)"] h| source data
+h| stem:[2 xx f("&#x200c;"^{1} "H") // "unitsml(Hz)"] h| stem:[u // "unitsml(Hz)"] h| source data
 
 | stem:[2466061413187035] | stem:[10] | <<parthey>>
 | stem:[2466061413187018] | stem:[11] | <<matveev>>
@@ -67,8 +68,17 @@ standard uncertainty by a factor of three.
 [bibliography]
 == References
 
-* [[[cipm-rec2,1]]], CIPM Recommendation 2 (CI-2015): Updates to the list of standard frequencies http://www.bipm.org/jsp/en/CIPMRecommendations.jsp
+* [[[cipm-rec2,(1)CIPM Recommendation 2 (2015)]]], CIPM Recommendation 2 (CI-2015):
+Updates to the list of standard frequencies
+http://www.bipm.org/jsp/en/CIPMRecommendations.jsp
 
-* [[[parthey,2]]], C. G. Parthey, A. Matveev, J. Alnis, B. Bernhardt, A. Beyer, R. Holzwarth, A. Maistrou, R. Pohl, K. Predehl, T. Udem, T. Wilken, N. Kolachevsky, M. Abgrall, D. Rovera, C. Salomon, P. Laurent, and T. W. Hänsch: Improved Measurement of the Hydrogen 1S–2S Transition Frequency, _Phys. Rev. Lett._ *107*, 203001 (2011).
+* [[[parthey,2]]], C. G. Parthey, A. Matveev, J. Alnis, B. Bernhardt, A. Beyer, R.
+Holzwarth, A. Maistrou, R. Pohl, K. Predehl, T. Udem, T. Wilken, N. Kolachevsky, M.
+Abgrall, D. Rovera, C. Salomon, P. Laurent, and T. W. Hänsch: Improved Measurement of
+the Hydrogen 1S--2S Transition Frequency, _Phys. Rev. Lett._ *107*, 203001 (2011).
 
-* [[[matveev,3]]], A. Matveev, Ch. G. Parthey, K. Predehl, J. Alnis, A. Beyer, R. Holzwarth, Th. Udem, T. Wilken, N. Kolachevsky, M. Abgrall, D. Rovera, Ch. Salomon, Ph. Laurent, G. Grosche, O. Terra, Th. Legero, H. Schnatz, S. Weyers, B. Altschul, Th. W. Hänsch: Precision Measurement of the Hydrogen stem:[rm(1S - 2S)] Frequency via a 920-km Fiber Link, _Phys. Rev. Lett._ *110*, 230801 (2
+* [[[matveev,3]]], A. Matveev, Ch. G. Parthey, K. Predehl, J. Alnis, A. Beyer, R.
+Holzwarth, Th. Udem, T. Wilken, N. Kolachevsky, M. Abgrall, D. Rovera, Ch. Salomon,
+Ph. Laurent, G. Grosche, O. Terra, Th. Legero, H. Schnatz, S. Weyers, B. Altschul,
+Th. W. Hänsch: Precision Measurement of the Hydrogen stem:[1S - 2S] Frequency via a
+stem:[920-"unitsml(km)"] Fiber Link, _Phys. Rev. Lett._ *110*, 230801 (2013).

sources/rec-values/mep-wgfs-nm266-199Hg_1129THz/2021/document.adoc

@@ -0,0 +1,92 @@
+= Recommended Values of Standard Frequencies: Mercury 199 Atom (stem:[f ~~ 1129 "unitsml(THz)"])
+:appendix-id: 2
+:partnumber: 2.3
+:edition: 9
+:copyright-year: 2019
+:language: en
+:docnumber: SI MEP M REC 1129THz
+:title-appendix-en: Recommended values of standard frequencies for applications including the practical realization of the metre and secondary representations of the second
+:title-appendix-fr: Valeurs recommandées des fréquences étalons destinées à la mise en pratique de la définition du mètre et aux représentations secondaires de la seconde
+:title-part-en: Mercury 199 Atom (stem:[f ~~ 1129 "unitsml(THz)"])
+:title-part-fr: Mercury 199 Atom (stem:[f ~~ 1129 "unitsml(THz)"])
+:title-en: The International System of Units
+:title-fr: Le système international d'unités
+:doctype: mise-en-pratique
+:committee-acronym: CCL-CCTF-WGFS
+:committee-en: CCL-CCTF Frequency Standards Working Group
+:si-aspect: m_c_deltanu
+:docstage: in-force
+:confirmed-date: 2021-03
+:revdate: 2022-04-13
+:imagesdir: images
+:mn-document-class: bipm
+:mn-output-extensions: xml,html,pdf,rxl
+:local-cache-only:
+:data-uri-image:
+
+[%unnumbered]
+== {blank}
+
+*stem:["‌"^{199} "Hg"] neutral atom, stem:[6"s"^2" ‌"^1"S"_0 - 6"s"6"p"" "^3"P"_0] unperturbed optical transition*
+
+== Recommended value <<cctf22>> of the frequency in the CIPM List of Frequencies
+
+stem:[f("&#x200c;"^{199} "Hg") = 1128575290808154.32 "unitsml(Hz)"]
+
+equivalent to
+
+stem:[ii(lambda)("&#x200c;"^{199} "Hg") = 265637977.75983897 "unitsml(fm)"],
+
+with a relative standard uncertainty of stem:[2.4 xx 10^(-16)].
+
+This radiation was endorsed by the CCTF as a secondary representation of the
+definition of the second <<cctf21>>.
+
+== Method to establish the recommended value
+
+A global adjustment of all measurements of frequency ratios published in
+peer-reviewed publications and available to the CCL-CCTF WGFS was carried out
+following the methods presented in <<margolis;to!riehle>>.
+
+This adjustment determines the frequency of 14 transitions (see <<fig1>>) which are
+either already adopted as secondary representations of the second <<riehle>> or
+considered as candidates for SRS. It took into account 105 measurements, including 33
+frequency ratios and 72 absolute frequency measurements (i.e. ratios to the
+stem:["&#x200c;"^{133} "Cs"] frequency). A total of 483 correlations between these
+input measurements were estimated and considered in the adjustment. More details on
+the input data and the processing are provided at
+https://webtai.bipm.org/ftp/pub/tai/publication/wgfs/Adjustment_2021.html . The
+recommended value is the direct result of the adjustment, rounded as deemed adequate
+with respect to the recommended uncertainty.
+
+While the results are from a global adjustment, it is of interest to note (see
+<<fig1>>) that the stem:["&#x200c;"^{199} "Hg"] transition is involved in 2
+measurements relative to stem:["&#x200c;"^{133} "Cs"], and in 4 frequency ratios, 3
+of which are with optical transitions.
+
+[[fig1]]
+.Representation of the 105 measurements linking 14 transitions on the circle and stem:["&#x200c;"^{133} "Cs"] at the center.
+image::fig-01.jpg[]
+
+[bibliography]
+== References
+
+* [[[cctf22,(1)CCTF Meeting 22]]], Consultative Committee for Time and Frequency
+(CCTF), 22 nd meeting (session II – online), Recommendation PSFS-2 available at
+https://www.bipm.org/en/committees/cc/cctf/22-_2-2021
+
+* [[[cctf21,(2)CCTF Meeting 21]]], Consultative Committee for Time and Frequency
+(CCTF): Report of the 21st meeting (8-9 June 2017), Recommendation CCTF 2
+https://www.bipm.org/utils/common/pdf/CC/CCTF/CCTF21.pdf
+
+* [[[margolis,(3)BIPM Metrologia 52 5 628]]], H. S. Margolis, P. Gill: Least-squares analysis of clock frequency comparison data to deduce optimized frequency and frequency ratio values; _Metrologia_ *52*, 628 (2015)
+
+* [[[robertsson,(4)BIPM Metrologia 53 6 1272]]], L. Robertsson: On the evaluation of ultra-high-precision frequency ratio measurements: examining closed loops in a graph theory framework; _Metrologia_ *53*, 1272 (2016)
+
+* [[[panfilo, 5]]], G. Panfilo, communication to the CCL-CCTF WGFS. A new
+implementation of [4] was realized in MatLab at the BIPM (2020)
+
+* [[[oates,6]]], Ch. Oates, communication to the CCL-CCTF WGFS. An independent
+program was developed in Mathematica at NIST (2017)
+
+* [[[riehle,(7)BIPM Metrologia 55 2 188]]], F. Riehle, P. Gill, F. Arias, L. Robertsson: The CIPM List of Recommended Frequency Standard Values: Guidelines and Procedures; _Metrologia_ *55*, 188-200 (2018)