metanorma / cgpm-resolutions Goto Github PK

CGPM / BIPM Resolutions in machine-readable format

cgpm-resolutions's Introduction

Metanorma: the standard for standards

Metanorma is dedicated to harmonizing standard documents produced by different standard-setting bodies in a manner that maintains correct semantics while allowing each standard publisher to define appropriate semantic extensions.

Simply put, it allows standards bodies or any other organization to create their own standard or specification document in a best practices manner.

Metanorma is composed of a number of specifications and software implementations. The Metanorma document model is based on the SecureDoc document model.

For more on Metanorma and who uses it, refer to https://www.metanorma.org

Installation on supported platforms

See https://www.metanorma.org/install/

Installing individual components

The Metanorma workflow can be utilized via the metanorma-cli Ruby gem.

gem install metanorma-cli

Usage

Refer to Metanorma man page and Metanorma usage

Threaded execution

Metanorma has threaded execution, to generate output documents from the same Presentation XML input more quickly. Similar to relaton, the METANORMA_PARALLEL environment variable can be used to override the default number of parallel fetches used.

Origin of name

Meta- is a prefix of Greek origin ("μετα") for “with” “after”. In English, it has ended up meaning "about (its own category)"; e.g. meta-discussion (a discussion about discussion). (For the roundabout way it ended up with that meaning, see https://en.wikipedia.org/wiki/Meta#Etymology.)

Norma is Latin for “rule” and “standard”; hence English norm, but also German Norm "standard".

The Metanorma project is for setting a standard for standard documents created by standards-setting organizations (which is a meta thing to do); hence this name.

Metanorma seeks to embrace all standards documents standards, but not possess any: it can give rise to many "standard" standards, but not limit the extension of any of those standards.

The motto of the project is Aequitate verum, "Truth through equity". Dealing with all standards fairly (aequitate), we seek not an abstract virtue (veritas), but a practical reality on the ground (verum), that can be used by stakeholders of multiple standards.

cgpm-resolutions's People

Contributors

Watchers

cgpm-resolutions's Issues

CGPM 3, 8, 9, 10, 11, 12, 13, 14, 15, 16 missing English resolutions

3rd CGPM

https://www.bipm.org/fr/CGPM/db/3/1/

https://www.bipm.org/en/CGPM/db/8/

8th CGPM

This page is all French:
https://www.bipm.org/en/CGPM/db/8

9th CGPM
https://www.bipm.org/en/CGPM/db/9

10th CGPM missing resolutions 1, 2, 5, 6.
https://www.bipm.org/en/CGPM/db/10

11th CGPM missing resolutions 1-5, 7-8, 11-12, 14-16
https://www.bipm.org/en/CGPM/db/11

12th CGPM missing resolutions 1-4, 9-10
https://www.bipm.org/en/CGPM/db/12

13th CGPM missing resolutions 2, 8-12
https://www.bipm.org/en/CGPM/db/13

14th CGPM missing resolutions 2, 4, 5
https://www.bipm.org/en/CGPM/db/14

15th CGPM missing resolutions 1, 3-4, 6-7, 11
https://www.bipm.org/en/CGPM/db/14

16th CGPM missing resolutions 1, 3-4, 6-7, 11
https://www.bipm.org/en/CGPM/db/14

Add French versions

Data cleaning: links to BIPM website should be absolute paths

e.g.

cgpm-resolutions/meetings-en/meeting-25.yml

Line 104 in c3087c8

 message: considering the provisions of Articles link:/utils/common/documents/official/metre-convention.pdf#page=17[7], 

=> link:https://www.bipm.org/utils/common/documents/official/metre-convention.pdf#page=17[7],

Data cleaning: links to resolutions should use a non-absolute syntax

Instead of link:/en/CGPM/db/24/1/[Resolution 1] we should do something like link:resolution:24-1[Resolution 1] or something like that.

Split 25th CGPM actions

cgpm-resolutions/meetings/meeting-25.yml

Lines 16 to 24 in 53ed2d0

 - type: recalling / further recalling 

 date_effective: 2014-11-20 

 message: |- 

  *recalling* 

  * link:/en/CGPM/db/24/1/[Resolution 1] adopted by the CGPM at its 24th meeting (2011), which takes note of the intention of the International Committee for Weights and Measures (CIPM) to propose a revision of the SI that links the definitions of the kilogram, ampere, kelvin, and mole to exact numerical values of the Planck constant _h_, elementary charge _e_, Boltzmann constant _k_, and Avogadro constant _N_~A~, respectively, and which revises the way the SI is defined including the wording of the definitions of the SI units for time, length, mass, electric current, thermodynamic temperature, amount of substance, and luminous intensity so that the reference constants on which the SI is based are clearly apparent, 

  * the many benefits summarized in Resolution 1 that will accrue to science, technology, industry, and commerce from such a revision, especially from linking the kilogram to an invariant of nature rather than to the mass of a material artefact, thereby ensuring its long-term stability, 

  * link:/en/CGPM/db/21/7/[Resolution 7] adopted by the CGPM at its 21st meeting (1999), which encourages work at the National Metrology Institutes (NMIs) that can lead to such a redefinition of the kilogram, 

  * link:/en/CGPM/db/23/12/[Resolution 12] adopted by the CGPM at its 23rd meeting (2007), which outlines the work that should be carried out by the NMIs, the International Bureau of Weights and Measures (BIPM), and the CIPM together with its Consultative Committees (CCs) that could enable the planned revision of the SI to be adopted by the CGPM,

Add URL sources of resolutions

e.g.
CGPM 1 French: https://www.bipm.org/fr/CGPM/db/1/1/
CGPM 1 English: https://www.bipm.org/en/CGPM/db/1/1/

Source file: https://www.bipm.org/utils/common/pdf/CGPM/CGPM1.pdf#page=34

Data cleaning: broken tables

e.g.

cgpm-resolutions/meetings-en/meeting-25.yml

Line 303 in c3087c8

  <center>11 980 000 euros in 2016</center><center>11 980 000 euros in 2017</center><center>11 980 000 euros in 2018</center><center>11 980 000 euros in 2019</center> 

Write script to fetch all resolutions from CGPM

Main page:
https://www.bipm.org/en/worldwide-metrology/cgpm/resolutions.html

On this page, all the conference outcomes are available, e.g. this:
https://www.bipm.org/en/CGPM/db/26

Then each of the resolutions can be shown, e.g.:
https://www.bipm.org/en/CGPM/db/26/1/

All this text of a resolution should be placed inside the Resolution Data Model format, see this for sample:
https://github.com/iso-tc154/resolutions-data

The text should be written in AsciiDoc format (see the samples), e.g.
https://github.com/iso-tc154/resolutions-data/blob/master/plenary/plenary-26.yaml

This task is to write a Ruby script to fetch all resolutions from this site to a directory of YAML files (1 YAML file per resolution, 1 directory per meeting).

Meeting files should use a 2-digit ID

Minor issue, for the filenames, prefer to have 2 digits for sorting: File.write("meetings/meeting-#{meeting_id}.yml"

3rd CGPM Resolution 1 missing content in English

https://www.bipm.org/fr/CGPM/db/3/1/

Considerations/Actions should be split

If a consideration/action is like this

cgpm-resolutions/meetings/meeting-1.yml

Lines 16 to 26 in 53ed2d0

 - type: considering 

 date_effective: 1889-09-28 

 message: |- 

  *considering* 

  * the "Compte rendu of the President of the Comité International des Poids et Mesures (CIPM)" and the "Report of the CIPM", which show that, by the collaboration of the French section of the International Metre Commission and of the CIPM, the fundamental measurements of the international and national prototypes of the metre and of the kilogram have been made with all the accuracy and reliability which the present state of science permits; 

  * that the international and national prototypes of the metre and the kilogram are made of an alloy of platinum with 10 per cent iridium, to within 0.0001; 

  * the equality in length of the international Metre and the equality in mass of the international Kilogram with the length of the Metre and the mass of the Kilogram kept in the Archives of France; 

  * that the differences between the national Metres and the international Metre lie within 0.01 millimetre and that these differences are based on a hydrogen thermometer scale which can always be reproduced thanks to the stability of hydrogen, provided identical conditions are secured; 

  * that the differences between the national Kilograms and the international Kilogram lie within 1 milligram; 

  * that the international Metre and Kilogram and the national Metres and Kilograms fulfil the requirements of the Metre Convention,

cgpm-resolutions/meetings/meeting-25.yml

Line 87 in 53ed2d0

*decides that*

it starts with the action type and only the action type, i.e. *considering* (allowing deviations like *decides that* which is not just *decides*)
it contains a list

Then we split this into multiple type: {foo} objects within a "action group".

For data like this:

cgpm-resolutions/meetings/meeting-25.yml

Lines 142 to 146 in 53ed2d0

 message: |- 

  *invites the CIPM to* 

  * implement its plans to provide sustainability for the BIPM Pension and Provident Fund whilst continuing to examine the longer term liability issue, 

  * inform Member States about the outcome of actuarial studies on the assets and liabilities of the BIPM Pension and Provident Fund in its regular financial publications and at the next meeting of the General Conference.

The "invites the CIPM to" should be extracted that the "CIPM" should be encoded as the subject:, while the message is retained.

cgpm-resolutions/meetings/meeting-25.yml

Lines 228 to 231 in 53ed2d0

  *invites* 

  * the Consultative Committees and the JCRB to continue their ongoing efforts to streamline operations within the existing framework, and to prepare for and contribute to the wider review in 2015, 

  * the CIPM to establish a working group under the chairmanship of its President, with membership to be determined at the 2015 workshop, to conduct a review of the implementation and operation of the CIPM MRA,

These are 2 separate actions with different subject:s, both belonging to the same "action group"

For data like this we should not split because it is clear they are one entry.

cgpm-resolutions/meetings/meeting-25.yml

Lines 27 to 32 in 53ed2d0

 message: |- 

  *considering that* there has been significant progress in completing the necessary work, including 

  * the acquisition of relevant data and their analysis by the Committee on Data for Science and Technology (CODATA) to obtain the required values of _h_, _e_, _k_, and _N_~A~, 

  * establishment by the BIPM of an ensemble of reference standards of mass to facilitate the dissemination of the unit of mass in the revised SI, 

  * the preparation of _mises-en-pratique_ for the new definitions of the kilogram, ampere, kelvin, and mole,

cgpm-resolutions/meetings/meeting-25.yml

Lines 35 to 39 in 53ed2d0

 message: |- 

  *noting that* further work by the Consultative Committee for Units (CCU), the CIPM, the BIPM, the NMIs and the CCs should focus on 

  * awareness campaigns to alert user communities as well as the general public to the proposed revision of the SI, 

  * the preparation of the 9th edition of the SI Brochure that presents the revised SI in a way that can be understood by a diverse readership without compromising scientific rigour,

CGPM 1st meeting missing English translation of sanctions

https://www.bipm.org/en/CGPM/db/1/1/

English:

French:

Translated:
A. Regarding international prototypes:

The Prototype of the meter chosen by the CIPM. This prototype, at the temperature of melting ice, shall henceforth represent the metric unit of length.
The Prototype of the kilogram adopted by the CIPM. This prototype shall henceforth be considered as the unit of mass.
The hydrogen thermometer centigrade scale in terms of which the equations of the prototype Metres have been established.

B. Regarding national prototypes:

Meters of platinum iridium, the equations of which, with respect to the international Prototype, are contained within the limit of 0.01 millimeter, with a probable error not exceeding ± 0.0002 millimeter.
Kilograms of platinum iridium, the equations of which are contained within the limit of 1 milligram, with a probable error not exceeding ± 0.005 milligram.

C. Regarding the equations of the national prototypes:
The equations of the national prototypes, as determined at the International Bureau, under the direction of the CIPM, and recorded in the Report of this Committee and on the certificates accompanying these prototypes.

Data cleaning: fake math should be converted to AsciiMath

As title.

cgpm-resolutions/meetings/meeting-25.yml

Line 50 in 53ed2d0

  * continued effort in the NMIs, the BIPM, and academic institutions to obtain data relevant to the determination of _h_, _e_, _k_, and _N_~A~ with the requisite uncertainties, 

CGPM resolutions missing for 2, 4-6

Provide unique URL per resolution and per meeting

There is a per resolution URL and a per meeting outcome URL. We need to assign these for every meeting file.

e.g.

25th CGPM meeting https://www.bipm.org/en/CGPM/db/25/
25th CGPM meeting resolution 1 https://www.bipm.org/en/CGPM/db/25/1/

	- type: recalling / further recalling
	date_effective: 2014-11-20
	message: \|-
	recalling

	* link:/en/CGPM/db/24/1/[Resolution 1] adopted by the CGPM at its 24th meeting (2011), which takes note of the intention of the International Committee for Weights and Measures (CIPM) to propose a revision of the SI that links the definitions of the kilogram, ampere, kelvin, and mole to exact numerical values of the Planck constant _h_, elementary charge _e_, Boltzmann constant _k_, and Avogadro constant _N_~A~, respectively, and which revises the way the SI is defined including the wording of the definitions of the SI units for time, length, mass, electric current, thermodynamic temperature, amount of substance, and luminous intensity so that the reference constants on which the SI is based are clearly apparent,
	* the many benefits summarized in Resolution 1 that will accrue to science, technology, industry, and commerce from such a revision, especially from linking the kilogram to an invariant of nature rather than to the mass of a material artefact, thereby ensuring its long-term stability,
	* link:/en/CGPM/db/21/7/[Resolution 7] adopted by the CGPM at its 21st meeting (1999), which encourages work at the National Metrology Institutes (NMIs) that can lead to such a redefinition of the kilogram,
	* link:/en/CGPM/db/23/12/[Resolution 12] adopted by the CGPM at its 23rd meeting (2007), which outlines the work that should be carried out by the NMIs, the International Bureau of Weights and Measures (BIPM), and the CIPM together with its Consultative Committees (CCs) that could enable the planned revision of the SI to be adopted by the CGPM,

	- type: considering
	date_effective: 1889-09-28
	message: \|-
	considering

	* the "Compte rendu of the President of the Comité International des Poids et Mesures (CIPM)" and the "Report of the CIPM", which show that, by the collaboration of the French section of the International Metre Commission and of the CIPM, the fundamental measurements of the international and national prototypes of the metre and of the kilogram have been made with all the accuracy and reliability which the present state of science permits;
	* that the international and national prototypes of the metre and the kilogram are made of an alloy of platinum with 10 per cent iridium, to within 0.0001;
	* the equality in length of the international Metre and the equality in mass of the international Kilogram with the length of the Metre and the mass of the Kilogram kept in the Archives of France;
	* that the differences between the national Metres and the international Metre lie within 0.01 millimetre and that these differences are based on a hydrogen thermometer scale which can always be reproduced thanks to the stability of hydrogen, provided identical conditions are secured;
	* that the differences between the national Kilograms and the international Kilogram lie within 1 milligram;
	* that the international Metre and Kilogram and the national Metres and Kilograms fulfil the requirements of the Metre Convention,

	message: \|-
	invites the CIPM to

	* implement its plans to provide sustainability for the BIPM Pension and Provident Fund whilst continuing to examine the longer term liability issue,
	* inform Member States about the outcome of actuarial studies on the assets and liabilities of the BIPM Pension and Provident Fund in its regular financial publications and at the next meeting of the General Conference.

	invites

	* the Consultative Committees and the JCRB to continue their ongoing efforts to streamline operations within the existing framework, and to prepare for and contribute to the wider review in 2015,
	* the CIPM to establish a working group under the chairmanship of its President, with membership to be determined at the 2015 workshop, to conduct a review of the implementation and operation of the CIPM MRA,

	message: \|-
	considering that there has been significant progress in completing the necessary work, including

	* the acquisition of relevant data and their analysis by the Committee on Data for Science and Technology (CODATA) to obtain the required values of _h_, _e_, _k_, and _N_~A~,
	* establishment by the BIPM of an ensemble of reference standards of mass to facilitate the dissemination of the unit of mass in the revised SI,
	* the preparation of _mises-en-pratique_ for the new definitions of the kilogram, ampere, kelvin, and mole,

	message: \|-
	noting that further work by the Consultative Committee for Units (CCU), the CIPM, the BIPM, the NMIs and the CCs should focus on

	* awareness campaigns to alert user communities as well as the general public to the proposed revision of the SI,
	* the preparation of the 9th edition of the SI Brochure that presents the revised SI in a way that can be understood by a diverse readership without compromising scientific rigour,

metanorma / cgpm-resolutions Goto Github PK

cgpm-resolutions's Introduction

Metanorma: the standard for standards

Installation on supported platforms

Installing individual components

Usage

Threaded execution

Origin of name

cgpm-resolutions's People

Contributors

Watchers

cgpm-resolutions's Issues

Recommend Projects

Recommend Topics

Recommend Org