The dimensions list file allows to modify dimensions in a model by using a list instead of a set of dimension checks. With the help of this file you
can perform more update operations than with a regular Dimension Check:
- change dimension name
- change tolerance mode
- change tolerance table type
- change dimension decimal places
- change dimension upper tolerance value
- change dimension lower tolerance value
- change dimension tolerance decimal places
The
dimension list file uses a table to define the properties of the parameters to be updated. The header line contains the names of the dimension
properties.
You can use comments within the file by starting each comment line with the sign ”!”. Example for a comment:
!This is the dimension list file to edit all dimensions in one run
For most values you can use the setting <ignore>. This instructs to program to ignore that specific value by not checking
or not updating it.
For each column in the header line you must set a value in the dimension line, otherwise the program will not work. If there
is no value to set, then use the setting <ignore>.
The table has search columns (e.g. DIM_SYMBOL_TEXT) and update columns (e.g. DIM_NEW_SYMBOL_TEXT). With the help of the search
columns you can find a subset of the dimensions and with the update columns you can change the properties of all dimensions
in the found subset.
The columns in the header line are:
- DIM_SYMBOL_TEXT
- Specifies the full name of the dimension to search
- supports wildcards: *
- cannot be empty
- DIM_DECIMAL_PLACES
- Specifies the number of the decimal places of the dimension to search
- supports wildcards: *
- cannot be empty
- DIM_TOLERANCE_MODE
- specifies the tolerance mode of the dimension to search
- valid values:
- NOMINAL
- PLUS_MINUS
- LIMITS
- PLUS_MINUS_SYM
- SYM_SUPERSCRIPT
- supports wildcards: *
- cannot be empty
- DIM_TOLERANCE_TABLE_TYPE
- specifies the type of the tolerance table for the dimension to search
- valid values:
- NONE
- GENERAL
- BROKEN_EDGE
- SHAFTS
- HOLES
- supports wildcards: *
- DIM_TOLERANCE_LOWER
- specifies the value of the lower tolerance limit of the dimension to search
- supports wildcards: *
- DIM_TOLERANCE_UPPER
- specifies the value of the upper tolerance limit of the dimension to search
- supports wildcards: *
- DIM_TOLERANCE_DECIMALS
- specifies the value of the tolerance decimal places of the dimension to search
- supports wildcards: *
- DIM_NEW_SYMBOL_TEXT
- the new name of the dimension to set if the dimension should be renamed. Works only if no wildcards used in the DIM_SYMBOL_TEXT
column.
- can be any valid dimension name or <ignore> to don’t change the name of the current dimension
- DIM_NEW_DECIMAL_PLACES
- the number of decimal places to set on the dimension(s) found through the search columns
- can be any unsigned integer value or <ignore> to leave the decimal places of the current dimension unchanged
- DIM_NEW_TOLERANCE_MODE
- Specifies the tolerance mode to be set to the dimension(s) found through the search columns
- valid values — same like DIM_TOLERANCE_MODE
- can be one of the valid values or <ignore> to leave the tolerance mode unchanged.
- DIM_NEW_TOLERANCE_TABLE_TYPE
- Specifies the tolerance table type to be set for the dimension(s) found through the search columns
- valid values — same like DIM_TOLERANCE_TABLE_TYPE
- can be any valid value or <ignore> to leave the tolerance table type as it is.
- DIM_NEW_TOLERANCE_LOWER
- Specifies the value of the lower tolerance to be set for the dimension(s) found through the search columns
- can be any real number value or <ignore> to leave the lower tolerance value as it is.
- DIM_NEW_TOLERANCE_UPPER
- Specifies the value of the upper tolerance to be set for the dimension(s) found through the search columns
- can be any real number value or <ignore> to leave the upper tolerance value as it is.
- DIM_NEW_TOLERANCE_DECIMALS
- Specifies the value of the decimal places for the tolerance values of the dimension(s) found through the search columns
- can be any unsigned integer value or <ignore> to leave the tolerance decimal places value as it is.