Skip to main content

Contributing to the unit catalog

At Cognite, we maintain a global unit catalog filled with units and unit systems that are accessible to all CDF projects. We believe in the power of open-source and collaboration, so we've made our unit catalog open to contributions from our users.

While we encourage contributions to enhance the unit catalog, it is important to note that the catalog is made available to all Cognite customers. Therefore, we will carefully evaluate each submission to ensure that the additions are suitable for our broad customer base.

How to contribute​

Step 1: Access the unit catalog repository​

Step 2: Familiarize yourself with the project​

  • Read the README file to understand the project structure, contribution guidelines, and validation requirements.

Step 3: Make your changes​

  • Edit the units.json and/or unitSystems.json files to add your new units or unit systems. Ensure that your additions conform to the validation rules and tests outlined in the README.
  • Provide a reliable source for the unit conversion factors. Accepted sources include UoM standards (e.g., Energistics, qudt.org), books, or journals. Google or Wikis are not considered valid sources.

Step 4: Submit a pull request​

  • Save your changes and raise a Pull request (PR).
  • To expedite the review process, we recommend creating one PR per unit, or bundling up to 5 units per PR. Larger PRs may take longer to review.

Step 5: Review and approval​

  • Your PR will be reviewed by Cognite engineering to ensure it meets the contribution guidelines and is suitable for inclusion in the unit catalog.
  • The review process may result in a request for changes or clarification, or the PR may be accepted and merged directly.

Step 6: Release and deployment​

  • Once your PR is approved and merged, a new version of the unit catalog will be released and the changes will be deployed to all CDF projects.
tip

Note: Cognite reserves the right to evaluate and refuse additions that are not suitable for our broad customer base. We appreciate your understanding and cooperation in this regard.

Last updated