Working with the unit of measure definitions file

The unit of measure definitions file specifies the attributes of each unit of measure in the Teamcenter unit management system (UMS), combining aspects of Teamcenter units of measure and the Classification unit management system. During Teamcenter installation and upgrade, the definitions in this file are used to create the units of measure in the UMS. Teamcenter administrators can also use this file with the ums_import_unit_definitions utility to manage units of measure. The unit of measure definitions file supplied with Teamcenter is \unit_definitions.csv. Each line in the file defines a particular unit of measure. Columns define the attributes for each unit of measure. Warning When editing the unit_definitions.csv file, ensure that you do not change existing Conversion multiplication factor and Conversion addition factor values or enter inaccurate values for these attributes when creating new unit definitions. Inaccurate values for these attributes will cause compromised data when converting between measurement systems. When editing a unit of measure definition .csv file with an ASCII editor, save the .csv file with a UTF-8-BOM encoding. If saving a .xlsx file as a .csv file, save the file using the "CSV UTF-8 (Comma Delimited)" format. Doing so ensures that characters such as angstrom symbols, superscripts, and ohm symbols are saved correctly in the file. If you are running Teamcenter in a non-UTF8 environment, see Running the UMS in non-UTF-8 environments. Make sure you back up your .csv file before making any changes to the file. As an authoring aid, an annotated .xls version of this .csv file is also available in the directory. Instead of directly editing unit_definitions.csv, consider editing unit_definitions.xls. When your edits are complete, save unit_definitions.xls as a comma-delimited .csv file, remove the first line (the topmost header row) of the new .csv file, and resave the file. You can then use this .csv file to create and manage the units of measure. Following is a description of the unit_definitions.csv file contents. Classification Properties Classification properties define the attributes of a unit of measure and how it relates to other units of measure of the same type. ID A unique identifier for the unit of measure. ID is referred to as the "Object ID" attribute in Classification. Master A unit of measure can be associated with only one UMS object (a Classification unit definition). When multiple units have the same dimensionality (see Dimensionality later in this topic), only one of these units can be designated as the unit associated with the UMS object. Designate this unit with a value of Y in this column. Set this column value for the other units using the same dimensionality to N. Quantity The type of measurement, for example, length, mass, temperature, and so on. Quantity is referred to as the "Measure" attribute in Classification. Unit name The name of the unit as displayed in Teamcenter. Symbol The scientific symbol representing the unit of measure. Symbols must be unique and used only once in the file. Symbol is referred to as the "Unit display name" attribute in Classification. System of Measurement The measurement system the unit belongs to. If the unit of measure is a metric unit, identify it as such with a value of m. Identify all other units with a value of nm (non-metric). Base unit The unit of measure within a quantity that is used to calculate the values of other units of measure in that quantity. Identify the base unit of measure with a value of Y. Identify all other units of measure in the same quantity with a value of N. Conversion multiplication factor The value by which the quantity's base unit must be multiplied to derive this unit of measure's value. Warning Ensure that you do not change existing Conversion multiplication factor and Conversion addition factor values or enter inaccurate values for these attributes when creating new unit definitions. Inaccurate values for these attributes will cause compromised data when converting between measurement systems. Conversion addition factor Any value that must be added after applying the conversion multiplication factor. Conversion addition factors typically apply only to temperature units of measure. Warning Ensure that you do not change existing Conversion multiplication factor and Conversion addition factor values or enter inaccurate values for these attributes when creating new unit definitions. Inaccurate values for these attributes will cause compromised data when converting between measurement systems. Ignore for Optimization Specifies whether this unit of measure should not have its value optimized in Classification. Set this value to Y to exclude this unit of measure from optimization. Set this value to N to include this unit of measure for optimization. Number of Decimal Places The number of digits displayed to the right of the decimal when using the Classification application. NX Unit ID The ID value for this unit of measure in NX. NX Display Specifies that the unit is part of the list of units shown in NX when creating a part. ECLASS IRDI The ECLASS International Registration Data Identifier (IRDI) value for this unit of measure. Display Set Identifies units as members of specific display set (on the MBSE Parameters tab). Set this value to Y to include this unit a particular display set. Set this value to N to exclude this unit from a particular display set. When multiple units have the same dimensionality, only 1 of the units can be included in a particular display set. The following display sets are provided with Teamcenter. You can edit these sets and . Metric Display Set Metric(SI) Display Set Non-Metric Display Set Base install and application specific units When installing Teamcenter, certain basic units and units related to specific detected applications are installed. These units are identified with a value of 1 in their respective columns. The default units identified for installation are a balance between necessity and volume of units. Enabling all units may be overwhelming to users in their everyday work. Edit these values as necessary for your site during installation. Quantity grouping Dimensionality is a comma-separated list of values representing the physical properties of the unit. A dimension is a property that you can measure. A unit is a way to assign a value to the dimension. For example, length is a dimension, but you measure it in units of feet or meters. You can measure each property with a variety of units, such as meter and inch, but each property can have only one dimension, such as length. The International System of Units (SI) defines the following seven base properties. Base Property Metric Unit English Unit Length Meter (m) Inch (in) Mass Kilogram (kg) Pound (lb) Time Second (s) Second (s) Electric Current Ampere (A) Ampere (A) Temperature Kelvin (K) Degree Fahrenheit (°F) Luminous Intensity Candela (cd) Candela (cd) Amount of Substance Mole (mol) Mole (mol) Using Dimensionality, you can express most of the physical properties as a combination of the base properties. For example, you can express Force as a combination of mass, length, and time as follows: Force = Mass x Length / Time2 Therefore, the dimensionality of Force is ML/T2. In the Dimensionality column, the dimensionality is represented by nine integers, each representing the exponent of one of the following basic properties: Length Time Temperature Electric charge Angle Delta temperature Luminous intensity Amount of substance For example, the dimensionality of Force is represented as 1,1,-2,0,0,0,0,0,0.