This guide provides step-by-step instructions on how to create a conversion logic for an individual source. It explains how to navigate to the appropriate page, add and edit the conversion logic, and create a formula using variables. It also provides tips and best practices to follow. By following this guide, NSCM Admins can easily set up and customize conversion logic for a specific emission sources in the system.
Alert: Alert! This is for a single source. If you want to create a Conversion Logic for multiple sources, use the Conversion Logic Templates page.
1. Navigate to https://app.northstarcarbon.com/dashboard
2. Click "Emission Sources"
3. "Search..." for the source you want to add the conversion to
4. Click the "pencil" icon to edit that specific source.
5. Click "Add new logic"
6. Click "New calculation"
7. Click the "Conversion logic name *" field and rename.
Alert: Alert! This name will be what shows up in the dropdown menu when selecting a Unit of Measurement in a data line.
8. Input "Conversion logic source (optional)"
Alert: Alert! While optional, it is a best practice to always provide a source.
9. Click the "Admin note (optional)" field.
Tip: Tip! If the equation is not straightforward, it is a best practice to explain how the conversion was developed in the event of an audit and/or the need to update.
10. Click the "+" icon to start adding variables
11. Enter a Field ID
Tip: Tip! Field ID will be used in the "Formula" section. Best practice is to use single lowercase letters.
i.e. a, b, c; x, y, z
This is not client facing.
Alert: Alert! DO NOT CHANGE A FEILD ID once you've saved it.
If you change the Field ID it will invalidate all data lines that had previously used this logic.
12. Enter a Label and Prefix or Postfix
Alert: Alert!
Labels are what the client sees in the data line.
Use the full name in the singular form.
i.e. Yard, Mile, Metric Ton
Pre/Post-Fix are what are shown in the summary of a data line.
Use the abbreviation for that unit of measure.
i.e. yd, mi, mt
13. Add additional variables (as necessary)
14. Create a "Formula" using the variables listed in the Fields.
Alert: Alert! Formula always needs to equal the base unit.
For example, if the base unit is "feet" and you want to convert from "yards" (there are 3 feet in a yard)
Field: a
Label: Yard
Postfix: yd
Formula: a*3
think "Feet=" a*3
15. Click "Save" under the Edit Emission source section
Tip: Tip! You should now see the conversion listed on the right hand side.