THIS 22.1

Format of the oa_pref File

Format of the oa_pref File

Entries are formatted in the following way:

<programme>*<option>: <setting>

For example: this*laser_paper_size: A4

The rules for formatting are:

  • The <programme>*<option>: string must start at column 1;
  • This string must be in lower case, and must not have any spaces in it.
  • The <setting> must be separated from the string by at least one space.
  • Lines starting with a " # " are treated as comments and are ignored.
  • (Users accustomed to setting the attributes of their window manager with the .Xdefaults file will recognise this format and syntax.)

"oa_pref" arguments valid for T/HIS

PreferenceTypeDescriptionValid argumentsDefault
auto_blank <string> Turn ON/OFF AutoBlank ON, OFF ON
auto_blank_mode <string> Set the default AutoBlank mode MODEL, COMPONENT_ID, ENTITY_TYPE, ENTITY_ID, COMPONENT_TYPE, SURFACE, CURVE MODEL
auto_update <logical> Automatically replot graph after changing axis/title options TRUE, FALSE TRUE
csv_separator <string> CSV file field separator COMMA, TAB, SPACE COMMA
datum_file <string> File containing DATUM line definitons   <none>
edit_output_in_primer <string> Edit/Create DATABASE cards related to T/HIS entities in PRIMER ON, OFF ON
error_handler <string> how to handle errors and exceptions no_action, mini_dump, trap_continue, trace_exit mini_dump
file_buffer_size <integer> File buffer size used for read THF (d3thdt) files 512 - 1048576 4096
master_group_file <string> Filename for default group information   <none>
null_value <real> Value to assign to curves when data doesn't exist   1.0E+18
pemag_calculation_v12 <logical> Whether the PEMAG calculation uses the v12 logic. TRUE, FALSE FALSE
show_license_warning <logical> Display Window containing License System messages TRUE, FALSE TRUE
splash_screen_seen <real> Most recent version (as major.minor, eg 17.1) for which a splash screen has been seen   0.0


The following control automotive setup

PreferenceTypeDescriptionValid argumentsDefault
hic_time_window <real> Length of time window for HIC automotive operation. 1e-10 - 1e37 0.036
hic_scale_factor <real> Scale factor for acceleration used in HIC automotive operation. 1e-10 - 1e37 9.81
injury_text_colour <string> Colour used to display injury criteria values (hex code e.g. 0XA1B2C3 or core colour name e.g. OLIVE) FOREGROUND, WHITE, BLACK, RED, GREEN, BLUE, CYAN, MAGENTA, YELLOW, ORANGE, TURQUOISE, INDIGO, LIME, SKY, PINK, PALE_YELLOW, GOLD, OLIVE, DARK_MAGENTA, MEDIUM_GREEN, MEDIUM_BLUE, HOT_PINK, LIGHT_PINK, SEA_GREEN, MAROON, DARK_GREEN, PURPLE, NAVY, DARK_GREY, MEDIUM_GREY, LIGHT_GREY FOREGROUND
injury_line_colour <string> Colour used to display injury criteria lines (hex code e.g. 0XA1B2C3 or core colour name e.g. OLIVE) FOREGROUND, WHITE, BLACK, RED, GREEN, BLUE, CYAN, MAGENTA, YELLOW, ORANGE, TURQUOISE, INDIGO, LIME, SKY, PINK, PALE_YELLOW, GOLD, OLIVE, DARK_MAGENTA, MEDIUM_GREEN, MEDIUM_BLUE, HOT_PINK, LIGHT_PINK, SEA_GREEN, MAROON, DARK_GREEN, PURPLE, NAVY, DARK_GREY, MEDIUM_GREY, LIGHT_GREY FOREGROUND


The following strings and values control formatting of values for graphs

PreferenceTypeDescriptionValid argumentsDefault
add_exponent_to_label <logical> Add axis multiplier to label TRUE, FALSE TRUE
second_y_axis <logical> Display 2nd y axis TRUE, FALSE FALSE

         x_axis
x_axis_type <string> Linear or Logarithmic X Axis type LOGARITHMIC, LINEAR LINEAR
x_grid_spacing_off <real> X-Axis Grid Spacing value   0.0
x_grid_spacing_int <real> X-Axis Grid Interval value   0.0
x_grid_spacing_auto <string> X-Axis Grid Spacing AUTOMATIC, LOCKED AUTOMATIC
x_axis_decimal_places <string> Number of decimal places displayed for X axis values 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, Default(3) Default(3)
x_axis_format <string> Format used to display X axis values Automatic, General, Scientific, Default(Automatic) Default(Automatic)

         y_axis
y_axis_type <string> Linear or Logarithmic X Axis type LOGARITHMIC, LINEAR LINEAR
y_grid_spacing_off <real> Y-Axis Grid Spacing value   0.0
y_grid_spacing_int <real> Y-Axis Grid Interval value   0.0
y_grid_spacing_auto <string> Y-Axis Grid Spacing AUTOMATIC, LOCKED AUTOMATIC
y_axis_decimal_places <string> Number of decimal places displayed for Y axis values 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, Default(3) Default(3)
y_axis_format <string> Format used to display Y axis values Automatic, General, Scientific, Default(Automatic) Default(Automatic)

         y2_axis
y2_axis_type <string> Linear or Logarithmic X Axis type LOGARITHMIC, LINEAR LINEAR
y2_align_zero <logical> Y2-Axis align with Y=0 TRUE, FALSE FALSE
y2_axis_decimal_places <string> Number of decimal places displayed for second Y axis values 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, Default(3) Default(3)
y2_axis_format <string> Format used to display second Y axis values Automatic, General, Scientific, Default(Automatic) Default(Automatic)


The following strings and values control checkpoint

PreferenceTypeDescriptionValid argumentsDefault
write_checkpoint_files <logical> Record checkpoint files for the T/His session. TRUE, FALSE FALSE
checkpoint_dir <string> Directory for checkpoint files, or "none" to suppress them altogether   <none>
show_checkpoint_files <logical> Show checkpoint playback panel upon T/His startup. TRUE, FALSE FALSE


The following control colours

PreferenceTypeDescriptionValid argumentsDefault
axis_colour <string> Axis colour (hex code e.g. 0XA1B2C3 or core colour name e.g. OLIVE) FOREGROUND, WHITE, BLACK, RED, GREEN, BLUE, CYAN, MAGENTA, YELLOW, ORANGE, TURQUOISE, INDIGO, LIME, SKY, PINK, PALE_YELLOW, GOLD, OLIVE, DARK_MAGENTA, MEDIUM_GREEN, MEDIUM_BLUE, HOT_PINK, LIGHT_PINK, SEA_GREEN, MAROON, DARK_GREEN, PURPLE, NAVY, DARK_GREY, MEDIUM_GREY, LIGHT_GREY FOREGROUND
background_colour <string> Background colour (hex code e.g. 0XA1B2C3 or core colour name e.g. OLIVE) FOREGROUND, WHITE, BLACK, RED, GREEN, BLUE, CYAN, MAGENTA, YELLOW, ORANGE, TURQUOISE, INDIGO, LIME, SKY, PINK, PALE_YELLOW, GOLD, OLIVE, DARK_MAGENTA, MEDIUM_GREEN, MEDIUM_BLUE, HOT_PINK, LIGHT_PINK, SEA_GREEN, MAROON, DARK_GREEN, PURPLE, NAVY, DARK_GREY, MEDIUM_GREY, LIGHT_GREY BLACK
border_colour <string> Border colour (hex code e.g. 0XA1B2C3 or core colour name e.g. OLIVE) FOREGROUND, WHITE, BLACK, RED, GREEN, BLUE, CYAN, MAGENTA, YELLOW, ORANGE, TURQUOISE, INDIGO, LIME, SKY, PINK, PALE_YELLOW, GOLD, OLIVE, DARK_MAGENTA, MEDIUM_GREEN, MEDIUM_BLUE, HOT_PINK, LIGHT_PINK, SEA_GREEN, MAROON, DARK_GREEN, PURPLE, NAVY, DARK_GREY, MEDIUM_GREY, LIGHT_GREY FOREGROUND
foreground_colour <string> Foreground colour (hex code e.g. 0XA1B2C3 or core colour name e.g. OLIVE) FOREGROUND, WHITE, BLACK, RED, GREEN, BLUE, CYAN, MAGENTA, YELLOW, ORANGE, TURQUOISE, INDIGO, LIME, SKY, PINK, PALE_YELLOW, GOLD, OLIVE, DARK_MAGENTA, MEDIUM_GREEN, MEDIUM_BLUE, HOT_PINK, LIGHT_PINK, SEA_GREEN, MAROON, DARK_GREEN, PURPLE, NAVY, DARK_GREY, MEDIUM_GREY, LIGHT_GREY WHITE
title_colour <string> Colour of title (hex code e.g. 0XA1B2C3 or core colour name e.g. OLIVE) FOREGROUND, WHITE, BLACK, RED, GREEN, BLUE, CYAN, MAGENTA, YELLOW, ORANGE, TURQUOISE, INDIGO, LIME, SKY, PINK, PALE_YELLOW, GOLD, OLIVE, DARK_MAGENTA, MEDIUM_GREEN, MEDIUM_BLUE, HOT_PINK, LIGHT_PINK, SEA_GREEN, MAROON, DARK_GREEN, PURPLE, NAVY, DARK_GREY, MEDIUM_GREY, LIGHT_GREY FOREGROUND
user_colour1 <string> User defined colour 1 (hex code e.g. 0XA1B2C3)   <none>
user_colour2 <string> User defined colour 2 (hex code e.g. 0XA1B2C3)   <none>
user_colour3 <string> User defined colour 3 (hex code e.g. 0XA1B2C3)   <none>
user_colour4 <string> User defined colour 4 (hex code e.g. 0XA1B2C3)   <none>
user_colour5 <string> User defined colour 5 (hex code e.g. 0XA1B2C3)   <none>
user_colour6 <string> User defined colour 6 (hex code e.g. 0XA1B2C3)   <none>
user_colours_file <string> Location of the user-defined colours XML file.   <none>
user_text_colour <string> Colour for user text (hex code e.g. 0XA1B2C3 or core colour name e.g. OLIVE) FOREGROUND, WHITE, BLACK, RED, GREEN, BLUE, CYAN, MAGENTA, YELLOW, ORANGE, TURQUOISE, INDIGO, LIME, SKY, PINK, PALE_YELLOW, GOLD, OLIVE, DARK_MAGENTA, MEDIUM_GREEN, MEDIUM_BLUE, HOT_PINK, LIGHT_PINK, SEA_GREEN, MAROON, DARK_GREEN, PURPLE, NAVY, DARK_GREY, MEDIUM_GREY, LIGHT_GREY FOREGROUND
save_colours_on_exit <logical> Automatically save the user colours XML file when the program exits. TRUE, FALSE TRUE


The following control whether and how crash dump information is sent by email following a crash

PreferenceTypeDescriptionValid argumentsDefault
cd_compose_email <logical> Whether or not to offer to compose an email for sending minidump files. TRUE, FALSE TRUE
cd_email_address <string> Email address in To: field of crash dump emails.   dyna.support@arup,com
cd_cc_addresses <string> Email address(es) in Cc: field of crash dump emails.   <none>
cd_custom_email <string> Custom method of sending emails.   <none>
cd_dump_directory <string> Directory in which to save crash dump files   <none>
cd_email_method <string> Method used to create crash dump emails. BEST_EFFORT, SYSTEM_DEFAULT, OUTLOOK_CLI, URL_MAILTO, CUSTOM BEST_EFFORT
cd_minidump_file <string> Whether or not to create minidump files, and what to do with them. NOT_USED, SAVED_ONLY, EMAILED_ONLY, SAVED_AND_EMAILED SAVED_AND_EMAILED


The following options control the automatic creation of curve groups.

PreferenceTypeDescriptionValid argumentsDefault
group_by_model <logical> Automatically create a curve group for each model TRUE, FALSE TRUE
group_by_type <logical> Automatically create a curve group for each entity type data is read for TRUE, FALSE FALSE
group_by_component <logical> Automatically create a curve group for each component type data is read for TRUE, FALSE FALSE
component_group_name <string> Controls how curve groups created for components are named) COMPONENT, COMPONENT_AND_TYPE COMPONENT
group_by_file_index <logical> Automatically create a curve group based on the index of a curve read from a curve file TRUE, FALSE FALSE


The following options control the columns that are dsiplayed by default in the curve table

PreferenceTypeDescriptionValid argumentsDefault
ctable_show_curve_id <logical> Display Curve IDs TRUE, FALSE TRUE
ctable_show_label <logical> Display Curve Labels TRUE, FALSE TRUE
ctable_show_model <logical> Display Files / Models TRUE, FALSE TRUE
ctable_show_type <logical> Display Entity Types TRUE, FALSE TRUE
ctable_show_entity_id <logical> Display Entity Ids TRUE, FALSE TRUE
ctable_show_component <logical> Display Components TRUE, FALSE TRUE
ctable_show_style <logical> Display Curve Styles TRUE, FALSE TRUE
ctable_show_directory <logical> Display Directories TRUE, FALSE TRUE
ctable_show_miny <logical> Display minimum Y value TRUE, FALSE TRUE
ctable_show_maxy <logical> Display maximum Y value TRUE, FALSE TRUE
ctable_show_minposy <logical> Display minimum positive Y value TRUE, FALSE FALSE
ctable_show_minx <logical> Display minimum X value TRUE, FALSE TRUE
ctable_show_maxx <logical> Display maximum X value TRUE, FALSE TRUE
ctable_show_minposx <logical> Display minimum positive Y value TRUE, FALSE FALSE
ctable_show_xatminy <logical> Display X at minimum Y value TRUE, FALSE TRUE
ctable_show_xatmaxy <logical> Display X at maximum Y value TRUE, FALSE TRUE
ctable_show_xatminposy <logical> Display X atminimum positive Y value TRUE, FALSE FALSE
ctable_show_average <logical> Display average value TRUE, FALSE TRUE
ctable_show_rms <logical> Display RMS value TRUE, FALSE TRUE
ctable_show_points <logical> Display number of points TRUE, FALSE TRUE
ctable_show_hic <logical> Display HIC value TRUE, FALSE TRUE
ctable_show_hicd <logical> Display HICD value TRUE, FALSE TRUE
ctable_show_tms <logical> Display TMS value TRUE, FALSE TRUE
ctable_show_tti <logical> Display TTI value TRUE, FALSE TRUE
ctable_show_thiv <logical> Display THIV value TRUE, FALSE TRUE
ctable_show_phd <logical> Display PHD value TRUE, FALSE TRUE
ctable_show_corr <logical> Display CORR value TRUE, FALSE TRUE
ctable_show_olc <logical> Display OLC value TRUE, FALSE TRUE
ctable_properties_on <logical> Display the properties columns TRUE, FALSE false
ctable_injuryvals_on <logical> Display the injury values columns TRUE, FALSE false


The following options control the preferred order of data sources for various entities

PreferenceTypeDescriptionValid argumentsDefault
use_elout <logical> Use ELOUT in preference to ELOUTDET for Shell and ThickShell data components from LSDA file TRUE, FALSE FALSE
global <ordered> Data source for global data LSDA, ASCII, THF, none <none>
part <ordered> Data source for part data LSDA, ASCII, THF, none <none>
node <ordered> Data source for node data THF, LSDA, ASCII, none <none>

         elements
solid <ordered> Data source for solid data THF, LSDA, none <none>
beam <ordered> Data source for beam data THF, LSDA, none <none>
shell <ordered> Data source for shell data THF, LSDA, none <none>
tshell <ordered> Data source for thick shell data THF, LSDA, none <none>
spring <ordered> Data source for spring data LSDA, ASCII, XTF, none <none>
seatbelt <ordered> Data source for seatbelt data LSDA, ASCII, XTF, none <none>
retractor <ordered> Data source for retractor data LSDA, ASCII, XTF, none <none>
slipring <ordered> Data source for slipring data LSDA, ASCII, XTF, none <none>
wall <ordered> Data source for rigid wall data LSDA, ASCII, XTF, none <none>
contact <ordered> Data source for contact data LSDA, ASCII, XTF, none <none>
reaction <ordered> Data source for nodal reaction data LSDA, ASCII, XTF, none <none>
airbag <ordered> Data source for airbag data LSDA, ASCII, XTF, none <none>
joint <ordered> Data source for joint data LSDA, ASCII, none <none>
section <ordered> Data source for section data LSDA, ASCII, none <none>
subsystem <ordered> Data source for subsystems data LSDA, ASCII, none <none>
geo_contact <ordered> Data source for geometric contact data LSDA, ASCII, none <none>
nodal_rb <ordered> Data source for nodal rigid body data LSDA, ASCII, none <none>
weld <ordered> Data source for spotweld data LSDA, ASCII, none <none>
spc <ordered> Data source for spc data LSDA, ASCII, none <none>
boundary <ordered> Data source for boundary data LSDA, ASCII, none <none>
fsi <ordered> Data source for fluid structural interaction data LSDA, ASCII, none <none>
sph <ordered> Data source for SPH data LSDA, ASCII, none <none>
tracer <ordered> Data source for TRACER data LSDA, ASCII, none <none>
pulley <ordered> Data source for PULLEY data LSDA, ASCII, none <none>
prtube <ordered> Data source for PRTUBE data LSDA, ASCII, none <none>
pblast <ordered> Data source for Particle Blast data LSDA, ASCII, none <none>
bearing <ordered> Data source for BEARING data LSDA, ASCII, none <none>


The following strings and values control display options

PreferenceTypeDescriptionValid argumentsDefault
axis_width <real> Default line width for axis (pixels) 1.0, 2.0, 4.0, 8.0 2.0
axis_colour <string> Axis colour (hex code e.g. 0XA1B2C3 or core colour name e.g. OLIVE) FOREGROUND, WHITE, BLACK, RED, GREEN, BLUE, CYAN, MAGENTA, YELLOW, ORANGE, TURQUOISE, INDIGO, LIME, SKY, PINK, PALE_YELLOW, GOLD, OLIVE, DARK_MAGENTA, MEDIUM_GREEN, MEDIUM_BLUE, HOT_PINK, LIGHT_PINK, SEA_GREEN, MAROON, DARK_GREEN, PURPLE, NAVY, DARK_GREY, MEDIUM_GREY, LIGHT_GREY FOREGROUND
axis_top <string> Turn ON/OFF drawing of graph top axis ON, OFF ON
axis_right <string> Turn ON/OFF drawing of graph right axis ON, OFF ON
background_colour <string> Background colour (hex code e.g. 0XA1B2C3 or core colour name e.g. OLIVE) WHITE, BLACK, RED, GREEN, BLUE, CYAN, MAGENTA, YELLOW, RED/MAGENTA, GREEN/CYAN, INDIGO, YELLOW/GREEN, LIGHT_BLUE, DARK_ORANGE, PALE_YELLOW, GOLD, OLIVE, DARK_MAGENTA, MEDIUM_GREEN, CYAN/BLUE, HOT_PINK, RED/ORANGE, SEA_GREEN, MAROON, DARK_GREEN, PURPLE, NAVY, DARK_GREY, GREY, LIGHT_GREY, AUTO BLACK
border_on <logical> Display border TRUE, FALSE TRUE
border_width <real> Default line width for border (pixels) 1.0, 2.0, 4.0, 8.0 1.0
border_colour <string> Border colour (hex code e.g. 0XA1B2C3 or core colour name e.g. OLIVE) FOREGROUND, WHITE, BLACK, RED, GREEN, BLUE, CYAN, MAGENTA, YELLOW, ORANGE, TURQUOISE, INDIGO, LIME, SKY, PINK, PALE_YELLOW, GOLD, OLIVE, DARK_MAGENTA, MEDIUM_GREEN, MEDIUM_BLUE, HOT_PINK, LIGHT_PINK, SEA_GREEN, MAROON, DARK_GREEN, PURPLE, NAVY, DARK_GREY, MEDIUM_GREY, LIGHT_GREY FOREGROUND

         display_lines
lines_on <logical> Display lines TRUE, FALSE TRUE
line_width <real> Default line width for curves (pixels) 1.0, 2.0, 4.0, 8.0 2.0
fix_styles <logical> Fix curve styles to cycle through the default colours/styles regardless of the curve number TRUE, FALSE FALSE
foreground_colour <string> Foreground colour (hex code e.g. 0XA1B2C3 or core colour name e.g. OLIVE) FOREGROUND, WHITE, BLACK, RED, GREEN, BLUE, CYAN, MAGENTA, YELLOW, ORANGE, TURQUOISE, INDIGO, LIME, SKY, PINK, PALE_YELLOW, GOLD, OLIVE, DARK_MAGENTA, MEDIUM_GREEN, MEDIUM_BLUE, HOT_PINK, LIGHT_PINK, SEA_GREEN, MAROON, DARK_GREEN, PURPLE, NAVY, DARK_GREY, MEDIUM_GREY, LIGHT_GREY WHITE

         grid
grid_on <logical> Display grid TRUE, FALSE TRUE
grid_width <real> Default line width for grid (pixels) 1.0, 2.0, 4.0, 8.0 1.0
grid_colour <string> Grid colour (hex code e.g. 0XA1B2C3 or core colour name e.g. OLIVE) FOREGROUND, WHITE, BLACK, RED, GREEN, BLUE, CYAN, MAGENTA, YELLOW, ORANGE, TURQUOISE, INDIGO, LIME, SKY, PINK, PALE_YELLOW, GOLD, OLIVE, DARK_MAGENTA, MEDIUM_GREEN, MEDIUM_BLUE, HOT_PINK, LIGHT_PINK, SEA_GREEN, MAROON, DARK_GREEN, PURPLE, NAVY, DARK_GREY, MEDIUM_GREY, LIGHT_GREY FOREGROUND

         legend
legend_bg_colour <string> Legends background colour (hex code e.g. 0XA1B2C3 or core colour name e.g. OLIVE) FOREGROUND, WHITE, BLACK, RED, GREEN, BLUE, CYAN, MAGENTA, YELLOW, ORANGE, TURQUOISE, INDIGO, LIME, SKY, PINK, PALE_YELLOW, GOLD, OLIVE, DARK_MAGENTA, MEDIUM_GREEN, MEDIUM_BLUE, HOT_PINK, LIGHT_PINK, SEA_GREEN, MAROON, DARK_GREEN, PURPLE, NAVY, DARK_GREY, MEDIUM_GREY, LIGHT_GREY BLACK
legend_bg_trans <integer> Legend background transparency 0 - 100 0
legend_layout <string> Layout of legend COL_LIST, AUTO, OFF, FLOAT AUTO
legend_columns <string> Number of columns to display in legend 1, 2, 3 2
prefix_format <string> Select the prefix formatting for Legend curve labels. MODEL, DIRECTORY, ROOTNAME, USER MODEL
show_prefix <string> Allows you to toggle the Legend curve label prefix On/Off AUTO, ON, OFF AUTO
plot_format <string> Default format of plot COLUMN, DEFAULT, AUTO, OFF, FULL, FLOATING DEFAULT
symbols_on <logical> Display symbols (hex code e.g. 0XA1B2C3 or core colour name e.g. OLIVE) TRUE, FALSE FALSE
symbol_freq <integer> Symbol Frequency 1 - 2147483646 1


The drive mappings allow T/HIS to convert equivalent folder names from Windows to Unix and visa versa. This is currently only in use for the JavaScript function DriveMapFilename.

PreferenceTypeDescriptionValid argumentsDefault
drive_a <string> Mapping from Windows drive A: to unix path   <none>
drive_b <string> Mapping from Windows drive B: to unix path   <none>
drive_c <string> Mapping from Windows drive C: to unix path   <none>
drive_d <string> Mapping from Windows drive D: to unix path   <none>
drive_e <string> Mapping from Windows drive E: to unix path   <none>
drive_f <string> Mapping from Windows drive F: to unix path   <none>
drive_g <string> Mapping from Windows drive G: to unix path   <none>
drive_h <string> Mapping from Windows drive H: to unix path   <none>
drive_i <string> Mapping from Windows drive I: to unix path   <none>
drive_j <string> Mapping from Windows drive J: to unix path   <none>
drive_k <string> Mapping from Windows drive K: to unix path   <none>
drive_l <string> Mapping from Windows drive L: to unix path   <none>
drive_m <string> Mapping from Windows drive M: to unix path   <none>
drive_n <string> Mapping from Windows drive N: to unix path   <none>
drive_o <string> Mapping from Windows drive O: to unix path   <none>
drive_p <string> Mapping from Windows drive P: to unix path   <none>
drive_q <string> Mapping from Windows drive Q: to unix path   <none>
drive_r <string> Mapping from Windows drive R: to unix path   <none>
drive_s <string> Mapping from Windows drive S: to unix path   <none>
drive_t <string> Mapping from Windows drive T: to unix path   <none>
drive_u <string> Mapping from Windows drive U: to unix path   <none>
drive_v <string> Mapping from Windows drive V: to unix path   <none>
drive_w <string> Mapping from Windows drive W: to unix path   <none>
drive_x <string> Mapping from Windows drive X: to unix path   <none>
drive_y <string> Mapping from Windows drive Y: to unix path   <none>
drive_z <string> Mapping from Windows drive Z: to unix path   <none>


The following options control the fasttcf preferences.

PreferenceTypeDescriptionValid argumentsDefault
ftcf_error_count <integer> Maximum number of errors before a FAST-TCF script terminates   10
ftcf_write_entity_names <string> Write entity names instead of entity IDs into FAST-TCF scripts TRUE, FALSE TRUE
ftcf_write_diadem_channel_names <string> Write DIAdem channel names instead of channel numbers into FAST-TCF scripts TRUE, FALSE TRUE
ftcf_write_user_colours <string> Write all user-defined colour definitions into FAST-TCF scripts TRUE, FALSE FALSE
ftcf_write_required_models <string> Reference only the models required by the FAST-TCF script, rather than all models in the session. E.g. capturing a graph that contains only data from model M2 will write the model into the script as model 1, so it can be run in a session containing 1 model. TRUE, FALSE TRUE


The following set of options defines how various files are handled by T/HIS.

PreferenceTypeDescriptionValid argumentsDefault
output_directory <string> Default output directory for images and other files when multiple models have been read LATEST_MODEL_READ, FIRST_MODEL_READ, LEGACY LATEST_MODEL_READ
start_in <string> Directory to start T/HIS in   <none>
macro_directory <string> Specify a directory for T/HIS to look in for MACRO definitions   $OA_INSTALL/this_library/macros
file_names <string> Controls default file filters. LSTC = d3thdt*, xtfile*, OASYS/ARUP = *.thf, *.xtf OASYS, ARUP, LSTC OASYS
file_timeout <integer> Timeout period in seconds before T/HIS automatically closes LSDA(binout) and THF (d3thdt) files 0 - 300 10
read_group_files <string> Default action when a group file is found in a model directory and T/HIS has already read a group file. IGNORE, DELETE, OVERWRITE, INCREMENT IGNORE


The following strings and values control axes, title, and legend formatting for graphs

PreferenceTypeDescriptionValid argumentsDefault
title_size <string> Font size for title 8, 10, 12, 14, 18, 24, Default Default
title_font <string> Font for title Helvetica_Medium, Helvetica_Bold, Courier_Medium, Courier_Bold, Times_Medium, Times_bold, Default Default
title_colour <string> Colour of title (hex code e.g. 0XA1B2C3 or core colour name e.g. OLIVE) FOREGROUND, WHITE, BLACK, RED, GREEN, BLUE, CYAN, MAGENTA, YELLOW, ORANGE, TURQUOISE, INDIGO, LIME, SKY, PINK, PALE_YELLOW, GOLD, OLIVE, DARK_MAGENTA, MEDIUM_GREEN, MEDIUM_BLUE, HOT_PINK, LIGHT_PINK, SEA_GREEN, MAROON, DARK_GREEN, PURPLE, NAVY, DARK_GREY, MEDIUM_GREY, LIGHT_GREY FOREGROUND
x_label_size <string> Font size for X axis label 8, 10, 12, 14, 18, 24, Default Default
x_label_font <string> Font for X axis label Helvetica_Medium, Helvetica_Bold, Courier_Medium, Courier_Bold, Times_Medium, Times_bold, Default Default
x_label_colour <string> Colour of X axis label (hex code e.g. 0XA1B2C3 or core colour name e.g. OLIVE) FOREGROUND, WHITE, BLACK, RED, GREEN, BLUE, CYAN, MAGENTA, YELLOW, ORANGE, TURQUOISE, INDIGO, LIME, SKY, PINK, PALE_YELLOW, GOLD, OLIVE, DARK_MAGENTA, MEDIUM_GREEN, MEDIUM_BLUE, HOT_PINK, LIGHT_PINK, SEA_GREEN, MAROON, DARK_GREEN, PURPLE, NAVY, DARK_GREY, MEDIUM_GREY, LIGHT_GREY FOREGROUND
x_axis_size <string> Font size for X axis units 8, 10, 12, 14, 18, 24, Default Default
x_axis_font <string> Font for X axis units Helvetica_Medium, Helvetica_Bold, Courier_Medium, Courier_Bold, Times_Medium, Times_bold, Default Default
x_axis_colour <string> Colour of X axis units (hex code e.g. 0XA1B2C3 or core colour name e.g. OLIVE) FOREGROUND, WHITE, BLACK, RED, GREEN, BLUE, CYAN, MAGENTA, YELLOW, ORANGE, TURQUOISE, INDIGO, LIME, SKY, PINK, PALE_YELLOW, GOLD, OLIVE, DARK_MAGENTA, MEDIUM_GREEN, MEDIUM_BLUE, HOT_PINK, LIGHT_PINK, SEA_GREEN, MAROON, DARK_GREEN, PURPLE, NAVY, DARK_GREY, MEDIUM_GREY, LIGHT_GREY FOREGROUND
y_label_size <string> Font size for Y axis label 8, 10, 12, 14, 18, 24, Default Default
y_label_font <string> Font for Y axis label Helvetica_Medium, Helvetica_Bold, Courier_Medium, Courier_Bold, Times_Medium, Times_bold, Default Default
y_label_colour <string> Colour of Y axis label (hex code e.g. 0XA1B2C3 or core colour name e.g. OLIVE) FOREGROUND, WHITE, BLACK, RED, GREEN, BLUE, CYAN, MAGENTA, YELLOW, ORANGE, TURQUOISE, INDIGO, LIME, SKY, PINK, PALE_YELLOW, GOLD, OLIVE, DARK_MAGENTA, MEDIUM_GREEN, MEDIUM_BLUE, HOT_PINK, LIGHT_PINK, SEA_GREEN, MAROON, DARK_GREEN, PURPLE, NAVY, DARK_GREY, MEDIUM_GREY, LIGHT_GREY FOREGROUND
y_axis_size <string> Font size for Y axis units 8, 10, 12, 14, 18, 24, Default Default
y_axis_font <string> Font for Y axis units Helvetica_Medium, Helvetica_Bold, Courier_Medium, Courier_Bold, Times_Medium, Times_bold, Default Default
y_axis_colour <string> Colour of Y axis units (hex code e.g. 0XA1B2C3 or core colour name e.g. OLIVE) FOREGROUND, WHITE, BLACK, RED, GREEN, BLUE, CYAN, MAGENTA, YELLOW, ORANGE, TURQUOISE, INDIGO, LIME, SKY, PINK, PALE_YELLOW, GOLD, OLIVE, DARK_MAGENTA, MEDIUM_GREEN, MEDIUM_BLUE, HOT_PINK, LIGHT_PINK, SEA_GREEN, MAROON, DARK_GREEN, PURPLE, NAVY, DARK_GREY, MEDIUM_GREY, LIGHT_GREY FOREGROUND
y2_label_size <string> Font size for second Y axis label 8, 10, 12, 14, 18, 24, Default Default
y2_label_font <string> Font for second Y axis label Helvetica_Medium, Helvetica_Bold, Courier_Medium, Courier_Bold, Times_Medium, Times_bold, Default Default
y2_label_colour <string> Colour of second Y axis label (hex code e.g. 0XA1B2C3 or core colour name e.g. OLIVE) FOREGROUND, WHITE, BLACK, RED, GREEN, BLUE, CYAN, MAGENTA, YELLOW, ORANGE, TURQUOISE, INDIGO, LIME, SKY, PINK, PALE_YELLOW, GOLD, OLIVE, DARK_MAGENTA, MEDIUM_GREEN, MEDIUM_BLUE, HOT_PINK, LIGHT_PINK, SEA_GREEN, MAROON, DARK_GREEN, PURPLE, NAVY, DARK_GREY, MEDIUM_GREY, LIGHT_GREY FOREGROUND
y2_axis_size <string> Font size for second Y axis units 8, 10, 12, 14, 18, 24, Default Default
y2_axis_font <string> Font for second Y axis units Helvetica_Medium, Helvetica_Bold, Courier_Medium, Courier_Bold, Times_Medium, Times_bold, Default Default
y2_axis_colour <string> Colour of second Y axis units (hex code e.g. 0XA1B2C3 or core colour name e.g. OLIVE) FOREGROUND, WHITE, BLACK, RED, GREEN, BLUE, CYAN, MAGENTA, YELLOW, ORANGE, TURQUOISE, INDIGO, LIME, SKY, PINK, PALE_YELLOW, GOLD, OLIVE, DARK_MAGENTA, MEDIUM_GREEN, MEDIUM_BLUE, HOT_PINK, LIGHT_PINK, SEA_GREEN, MAROON, DARK_GREEN, PURPLE, NAVY, DARK_GREY, MEDIUM_GREY, LIGHT_GREY FOREGROUND
legend_size <string> Font size for curve legends 8, 10, 12, 14, 18, 24, Default Default
legend_font <string> Font for second curve legends Helvetica_Medium, Helvetica_Bold, Courier_Medium, Courier_Bold, Times_Medium, Times_bold, Default Default
legend_colour <string> Colour of curve legends (hex code e.g. 0XA1B2C3 or core colour name e.g. OLIVE) FOREGROUND, WHITE, BLACK, RED, GREEN, BLUE, CYAN, MAGENTA, YELLOW, ORANGE, TURQUOISE, INDIGO, LIME, SKY, PINK, PALE_YELLOW, GOLD, OLIVE, DARK_MAGENTA, MEDIUM_GREEN, MEDIUM_BLUE, HOT_PINK, LIGHT_PINK, SEA_GREEN, MAROON, DARK_GREEN, PURPLE, NAVY, DARK_GREY, MEDIUM_GREY, LIGHT_GREY FOREGROUND
legend_display_lines <string> Turn User Lines On/Off ON, OFF ON


The following strings and values control how T/HIS starts

PreferenceTypeDescriptionValid argumentsDefault
auto_hide <logical> Hide graph tool bar TRUE, FALSE FALSE
graphics_type <string> Graphics format to start T/HIS with OPENGL, TTY, DEFAULT OPENGL
maximise <logical> Maximise window when T/HIS started TRUE, FALSE TRUE
image_format <string> Default image format BMP_8_C, BMP_8_UN, PNG_8, GIF_8, BMP_24_UN, PNG_24, JPG_24, PPM_24 PNG_24
intel_hd_use_shaders <string> Control usage of hardware shaders on Intel HD graphics cards AUTO_DETECT, FORCE_OFF, FORCE_ON AUTO_DETECT
placement <string> Location for initial window on multi-screen display LEFT, CENTRE, RIGHT, BOTTOM, TOP, LEFT_BOTTOM, LEFT_TOP, CENTRE_BOTTOM, CENTRE_TOP, RIGHT_BOTTOM, RIGHT_TOP <none>
rhs_number_columns <integer> Number of columns of Tools buttons 4 - 50 4
white_background_image <logical> Write images with white background TRUE, FALSE FALSE
bg_img_on <string> Turn the Background Image on or off. ON, OFF <none>
bg_img_path <string> Valid Background Image file path   <none>
bg_img_scale <string> Preset Background Image scaling WIDTH, HEIGHT, W+H <none>
bg_img_fact <real> Scale factor for Background Image Size   1
bg_img_just <string> Background Image Justification N, NE, E, SE, S, SW, W, NW <none>
bg_img_pos <string> Background Image Positioning TILED, SINGLE SINGLE
window_layout <string> Multiple window layout type TILE_WIDE, TILE_TALL, CASCADE, 1X1, 2X2, 3X3, XY TILE_WIDE
x_layout <integer> Number used for 'X x Y' layout, number of cols 1 - 8 1
y_layout <integer> Number used for 'X x Y' layout, number of rows 1 - 8 1
page_width <integer> Width of the page (pixels)   <none>
page_height <integer> Height of the page (pixels)   <none>


The following options control graphical user interface

PreferenceTypeDescriptionValid argumentsDefault
gui_theme <string> Graphical User Interface (GUI) theme LIGHT, DARK, CLASSIC, LEGACY LIGHT
gui_styling_mode <string> Graphical User Interface (GUI) styling and decoration NOT_USED, TIME_LIMIT, ALWAYS TIME_LIMIT
gui_styling_tlimit <integer> Graphical User Interface (GUI) menu repaint time limit to turn off decorations 0 - 100000 500


The following strings and values control laser plotting setup

PreferenceTypeDescriptionValid argumentsDefault
laser_paper_size <string> Default paper size A4, A3, US A4
laser_orientation <string> Default page orientation Portrait, Landscape Landscape
laser_top_margin <real> Top margin size in mm   10
laser_bottom_margin <real> Bottom margin size in mm   30
laser_left_margin <real> Left margin size in mm   20
laser_right_margin <real> Right margin size in mm   10


The following options affect the appearance and behaviour of the graphical user interface, left handed support, and the mouse

PreferenceTypeDescriptionValid argumentsDefault
display_factor <real> Factor on display size (0.5 - 2.0, automatic if undefined) 0.5 - 2.0 1.2
display_brightness <real> Menu brightness (0.0-1.0) 0.0 - 1.0 1.0
display_saturation <real> Menu colour saturation (0.0-1.0) 0.0 - 1.0 1.0
button_gradation <real> Button shade gradation (0.0-1.0) 0.0 - 1.0 0.0
dv_sync_windows <string> Dyn view method(s) for synchronising windows ICON, ICON+CAPS, ICON+NUM, ICON+CAPS+NUM ICON+CAPS
dv_left_shift <string> Dyn view action for shift + Left mouse ROTATION_XYZ, ROTATION_XY, ROTATION_Z, ROTATION_SPHERE, TRANSLATION, ZOOM_UP_+VE, ZOOM_DOWN_+VE, UNUSED ROTATION_XYZ
dv_middle_shift <string> Dyn view action for shift + Middle mouse ROTATION_XYZ, ROTATION_XY, ROTATION_Z, ROTATION_SPHERE, TRANSLATION, ZOOM_UP_+VE, ZOOM_DOWN_+VE, UNUSED TRANSLATION
dv_right_shift <string> Dyn view action for shift + Right mouse ROTATION_XYZ, ROTATION_XY, ROTATION_Z, ROTATION_SPHERE, TRANSLATION, ZOOM_UP_+VE, ZOOM_DOWN_+VE, UNUSED ZOOM_UP_+VE
dv_left_ctrl <string> Dyn view action for ctrl + Left mouse ROTATION_XYZ, ROTATION_XY, ROTATION_Z, ROTATION_SPHERE, TRANSLATION, ZOOM_UP_+VE, ZOOM_DOWN_+VE, UNUSED ROTATION_XYZ
dv_middle_ctrl <string> Dyn view action for ctrl + Middle mouse ROTATION_XYZ, ROTATION_XY, ROTATION_Z, ROTATION_SPHERE, TRANSLATION, ZOOM_UP_+VE, ZOOM_DOWN_+VE, UNUSED TRANSLATION
dv_right_ctrl <string> Dyn view action for ctrl + Right mouse ROTATION_XYZ, ROTATION_XY, ROTATION_Z, ROTATION_SPHERE, TRANSLATION, ZOOM_UP_+VE, ZOOM_DOWN_+VE, UNUSED ZOOM_UP_+VE
dv_left_both <string> Dyn view action for shift+ctrl + Left mouse ROTATION_XYZ, ROTATION_XY, ROTATION_Z, ROTATION_SPHERE, TRANSLATION, ZOOM_UP_+VE, ZOOM_DOWN_+VE, UNUSED ROTATION_XYZ
dv_middle_both <string> Dyn view action for shift+ctrl + Middle mouse ROTATION_XYZ, ROTATION_XY, ROTATION_Z, ROTATION_SPHERE, TRANSLATION, ZOOM_UP_+VE, ZOOM_DOWN_+VE, UNUSED TRANSLATION
dv_right_both <string> Dyn view action for shift+ctrl + Right mouse ROTATION_XYZ, ROTATION_XY, ROTATION_Z, ROTATION_SPHERE, TRANSLATION, ZOOM_UP_+VE, ZOOM_DOWN_+VE, UNUSED ZOOM_UP_+VE
dv_shift_action <string> Dynamic viewing mode for shift + mouse button CURRENT, WIREFRAME, FREE_EDGE, UNUSED CURRENT
dv_ctrl_action <string> Dynamic viewing mode for ctrl + mouse button CURRENT, WIREFRAME, FREE_EDGE, UNUSED WIREFRAME
dv_both_action <string> Dynamic viewing mode for shift+ctrl + mouse button CURRENT, WIREFRAME, FREE_EDGE, UNUSED FREE_EDGE
font_cache <logical> Whether to use cached fonts on Linux machines with no core X11 fonts loaded TRUE, FALSE TRUE
font_quality <string> The quality of font rendering in the graphical user interface PLAIN, ANTI-ALIAS ANTI-ALIAS
font_scaling <string> Whether text in GUI buttons can be scaled down to fit (TRUE means both width and height) FALSE, WIDTH, HEIGHT, TRUE WIDTH
font_silent <logical> whether to write explanatory text if wanted fonts are not found TRUE, FALSE FALSE
font_size <string> Menu font size TINY, SMALL, DEFAULT, LARGE, HUGE DEFAULT
font_type <string> Menu font typeface and strength HELVETICA, HELVETICA-BOLD, TIMES, TIMES-BOLD, COURIER, COURIER-BOLD HELVETICA
unix_prop_font <string> GUI proportional font for menu panels on Linux/Unix   Helvetica
unix_mono_font <string> GUI monospaced font for listing boxes on Linux/Unix   Courier New
windows_prop_font <string> GUI proportional font for menu panels on Windows   Helvetica
windows_mono_font <string> GUI monospaced font for listing boxes on Windows   Courier New
left_handed <string> Left handed switching of mouse and/or keyboard NONE, MOUSE, KEYBOARD, ALL NONE
zoom_factor <real> Zoom Factor for mouse wheel (0.01-1.0) 0.01 - 1.0 0.05
czoom_factor <real> Factor for right mouse dynamic zoom (0.01-0.2) 0.01 - 0.2 0.05
kzoom_factor <real> Factor for +/- keyboard short-cut keys 0.01 - 100.0 2.0
menu_dragging_mode <string> Mode used when moving menu panels with the mouse WIREFRAME, OPAQUE WIREFRAME
mouse_action_middle_button <string> Set the action for the middle mouse key during picking APPLY, REJECT, DESELECT REJECT
mouse_action_right_button <string> Set the action for the right mouse key during picking APPLY, REJECT, DESELECT DESELECT


The following control settings related to curve properties

PreferenceTypeDescriptionValid argumentsDefault
curve_property_number_format <string> Number format option for curves AUTO, SCIENTIFIC, GENERAL SCIENTIFIC
curve_property_dec_places <integer> Number of decimal places to display for curves 0 - 9 3


The following control settings related to quickfind

PreferenceTypeDescriptionValid argumentsDefault
quickfind_unmatched_text_colour <string> Text colour for unmatched characters (hex code e.g. 0XA1B2C3 or core colour name e.g. OLIVE) FOREGROUND, WHITE, BLACK, RED, GREEN, BLUE, CYAN, MAGENTA, YELLOW, ORANGE, TURQUOISE, INDIGO, LIME, SKY, PINK, PALE_YELLOW, GOLD, OLIVE, DARK_MAGENTA, MEDIUM_GREEN, MEDIUM_BLUE, HOT_PINK, LIGHT_PINK, SEA_GREEN, MAROON, DARK_GREEN, PURPLE, NAVY, DARK_GREY, MEDIUM_GREY, LIGHT_GREY BLACK
quickfind_matched_text_colour <string> Text colour for matched characters (hex code e.g. 0XA1B2C3 or core colour name e.g. OLIVE) FOREGROUND, WHITE, BLACK, RED, GREEN, BLUE, CYAN, MAGENTA, YELLOW, ORANGE, TURQUOISE, INDIGO, LIME, SKY, PINK, PALE_YELLOW, GOLD, OLIVE, DARK_MAGENTA, MEDIUM_GREEN, MEDIUM_BLUE, HOT_PINK, LIGHT_PINK, SEA_GREEN, MAROON, DARK_GREEN, PURPLE, NAVY, DARK_GREY, MEDIUM_GREY, LIGHT_GREY BLUE
quickfind_found_list_length <integer> Number of items to display in the found list 1 - 20 10
quickfind_recent_history <integer> Number of recently selected items to store 0 - 2147483646 10
quickfind_sequential_bonus <integer> Modifier for two successful adjacent matches 1 - 100 50
quickfind_word_start_bonus <integer> Modifier for successful match at word beginning 1 - 100 10
quickfind_box_size <string> Size and layout of Search box SMALL, LARGE SMALL


The following control the read options.

PreferenceTypeDescriptionValid argumentsDefault

         database
database_dir <string> Directory to look in for model database (XML) files   <none>
database_file <string> Default model database (XML) file   <none>
database_expand <integer> Number of levels to automatically expand in model database tree (-1 ALL) -1 - 2147483646 0

         equations
equation_x_start <real> X axis start value for equation curves. -1e37 - 1e37 0.0
equation_x_interval <real> X interval between points for equation curves. 1e-10 - 1e37 0.001
equation_npoints <real> Number of points for equation curves. Not used if equation_x_interval is defined. 1 - 1e7 0.001
equation_x_end <real> X axis end value for equation curves. -1e37 - 1e37 1.0

         ISO
iso_curve_labels <string> Curve label for ISO CHANNEL_NAME, CHANNEL_CODE CHANNEL_CODE
iso_list_labels <string> Default list labels in Read ISO panel FILENAME, CHANNEL_CODE FILENAME


The following options define how Javascripts are processed by THIS. See the JavaScript interface for further details.

PreferenceTypeDescriptionValid argumentsDefault
modules_directory <string> Directory for T/HIS to look for modules in   <none>
script_directory <string> Directory in which T/HIS looks for scripts   $OA_INSTALL/this_library/scripts
javascript_memory_size <integer> Initial memory allocated for garbage collection (MB) 1 - 4095 25
javascript_update_curve_menu <logical> Update curve menu contents while a JavaScript is running TRUE, FALSE FALSE


The following options define how T/HIS sessions are processed See T/HIS Session Save and Retrieve for further details.

PreferenceTypeDescriptionValid argumentsDefault
save_window_positions <logical> Save position of undocked windows between sessions TRUE, FALSE TRUE
session_auto_save <string> Save a session unconditionally on exit OFF, ON OFF
session_save_option <string> Location for automatically saving sessions HOME, USER_DEFINED, DESKTOP HOME
session_save_dir <string> User-defined location for session save   <none>
session_embed_cur_csv_files <string> Embed the external cur/csv files into the session. OFF, ON OFF
session_embed_curve_data <string> Embed the curve xy data for all curves into the session. OFF, ON OFF
show_session_retrieve_on_start <string> A pop-up panel to retrieve a saved T/HIS session file would show up every time T/HIS is launched. ON, OFF OFF


Keys can have functions assigned to them:

PreferenceTypeDescriptionValid argumentsDefault
F1_key <string> Shortcut for F1   <none>
F2_key <string> Shortcut for F2   <none>
F3_key <string> Shortcut for F3   <none>
F4_key <string> Shortcut for F4   <none>
F5_key <string> Shortcut for F5   <none>
F6_key <string> Shortcut for F6   <none>
F7_key <string> Shortcut for F7   <none>
F8_key <string> Shortcut for F8   <none>
F9_key <string> Shortcut for F9   <none>
F10_key <string> Shortcut for F10   <none>
F11_key <string> Shortcut for F11   <none>
F12_key <string> Shortcut for F12   <none>
A_key <string> Shortcut for A   AUTOSCALE
B_key <string> Shortcut for B   BLANK
C_key <string> Shortcut for C   CURVE_MENU
D_key <string> Shortcut for D   DATUM_MENU
E_key <string> Shortcut for E   <none>
F_key <string> Shortcut for F   FAST_TCF_MENU
G_key <string> Shortcut for G   NEW_WINDOW
H_key <string> Shortcut for H   <none>
I_key <string> Shortcut for I   <none>
J_key <string> Shortcut for J   JAVASCRIPT_MENU
K_key <string> Shortcut for K   <none>
L_key <string> Shortcut for L   <none>
M_key <string> Shortcut for M   <none>
N_key <string> Shortcut for N   EDIT_NEXT
O_key <string> Shortcut for O   <none>
P_key <string> Shortcut for P   PLOT
Q_key <string> Shortcut for Q   QUICK_PICK
R_key <string> Shortcut for R   REVERSE
S_key <string> Shortcut for S   <none>
T_key <string> Shortcut for T   TIDY_MENUS
U_key <string> Shortcut for U   UNBLANK
V_key <string> Shortcut for V   CURVE_GROUP
W_key <string> Shortcut for W   <none>
X_key <string> Shortcut for X   CURVE_TABLE
Y_key <string> Shortcut for Y   Y_AUTOSCALE
Z_key <string> Shortcut for Z   ZOOM
a_key <string> Shortcut for a   AUTOSCALE
b_key <string> Shortcut for b   BLANK
c_key <string> Shortcut for c   CURVE_MENU
d_key <string> Shortcut for d   DATUM_MENU
e_key <string> Shortcut for e   <none>
f_key <string> Shortcut for f   FAST_TCF_MENU
g_key <string> Shortcut for g   NEW_WINDOW
h_key <string> Shortcut for h   <none>
i_key <string> Shortcut for i   <none>
j_key <string> Shortcut for j   JAVASCRIPT_MENU
k_key <string> Shortcut for k   <none>
l_key <string> Shortcut for l   <none>
m_key <string> Shortcut for m   <none>
n_key <string> Shortcut for n   EDIT_NEXT
o_key <string> Shortcut for o   <none>
p_key <string> Shortcut for p   PLOT
q_key <string> Shortcut for q   QUICK_PICK
r_key <string> Shortcut for r   REVERSE
s_key <string> Shortcut for s   <none>
t_key <string> Shortcut for t   TIDY_MENUS
u_key <string> Shortcut for u   UNBLANK
v_key <string> Shortcut for v   CURVE_GROUP
w_key <string> Shortcut for w   <none>
x_key <string> Shortcut for x   CURVE_TABLE
y_key <string> Shortcut for y   Y_AUTOSCALE
z_key <string> Shortcut for z   ZOOM
SPACE_key <string> Shortcut for space   PLOT
ZERO_key <string> Shortcut for 0   COPY_AXIS
ONE_key <string> Shortcut for 1   TILE_TALL
TWO_key <string> Shortcut for 2   TILE_WIDE
THREE_key <string> Shortcut for 3   CASCADE
FOUR_key <string> Shortcut for 4   LAYOUT_1X1
FIVE_key <string> Shortcut for 5   LAYOUT_2X2
SIX_key <string> Shortcut for 6   LAYOUT_3X3
SEVEN_key <string> Shortcut for 7   <none>
EIGHT_key <string> Shortcut for 8   <none>
NINE_key <string> Shortcut for 9   <none>
EXCLAMATION_key <string> Shortcut for !   <none>
DOUBLEQUOTE_key <string> Shortcut for "   <none>
HASH_key <string> Shortcut for #   <none>
DOLLAR_key <string> Shortcut for $   <none>
PERCENT_key <string> Shortcut for %   <none>
AMPERSAND_key <string> Shortcut for &   <none>
SINGLEQUOTE_key <string> Shortcut for '   <none>
LEFTBRACKET_key <string> Shortcut for (   <none>
RIGHTBRACKET_key <string> Shortcut for )   <none>
ASTERISK_key <string> Shortcut for *   <none>
PLUS_key <string> Shortcut for +   ZOOM_IN
COMMA_key <string> Shortcut for ,   <none>
MINUS_key <string> Shortcut for -   ZOOM_OUT
DOT_key <string> Shortcut for .   <none>
SLASH_key <string> Shortcut for /   SHORTCUT
COLON_key <string> Shortcut for :   <none>
SEMICOLON_key <string> Shortcut for ;   <none>
LESSTHAN_key <string> Shortcut for <   <none>
EQUALS_key <string> Shortcut for =   ZOOM_IN
GREATERTHAN_key <string> Shortcut for >   <none>
QUESTIONMARK_key <string> Shortcut for ?   SHORTCUT
AT_key <string> Shortcut for @   <none>
LEFTSQUAREBRACKET_key <string> Shortcut for [   <none>
BACKSLASH_key <string> Shortcut for \   <none>
RIGHTSQUAREBRACKET_key <string> Shortcut for ]   <none>
CIRCUMFLEX_key <string> Shortcut for ^   <none>
UNDERSCORE_key <string> Shortcut for _   ZOOM_OUT
BACKTICK_key <string> Shortcut for `   <none>
LEFTCURLYBRACKET_key <string> Shortcut for {   <none>
PIPE_key <string> Shortcut for |   <none>
RIGHTCURLYBRACKET_key <string> Shortcut for }   <none>
TILDE_key <string> Shortcut for ~   <none>


The following options control settings.

PreferenceTypeDescriptionValid argumentsDefault
add_ascii_zero <logical> Automatically add point at time zero if required TRUE, FALSE FALSE
auto_regularise <logical> Always regularise curves before filtering TRUE, FALSE FALSE
convert_time <logical> Automatically convert from ms->s when filtering TRUE, FALSE FALSE
s_to_ms_conversion_time <real> Time threshold for seconds to milliseconds conversion   10.000
show_3ms_value <string> Display 3ms Clip value ON, OFF ON
show_hic_value <string> Display HIC value ON, OFF ON
show_phd_value <string> Display PHD value ON, OFF OFF
show_thiv_value <string> Display THIV value ON, OFF OFF
show_olc_value <string> Display OLC value ON, OFF OFF
vc_method <string> Default method for calculating Viscous Criteria ECER95, IIHS ECER95
asi_method <string> Default method for calculating Acceleration Severity Index 2010, 1998 2010
damage_method <string> Calculation method for calculating Damage injury metric rk4, rkf45, nbm rk4
automotive_constant_unit_system <string> Unit system of the constants in DMG, OLC and TI Operation U1, U2, U3, U4, U5, U6 U1
curve_palette <string> Controls how many colours are used by curves, default(6), extended(13), no_grey(27), full(30+any user defined) DEFAULT, EXTENDED, NO_GREY, FULL OFF
line_antialias <string> Draw lines using antialiasing OFF, ON ON
line_scale_dpi <string> Scale lines according to display DPI resolution OFF, ON ON
regularise_dt <real> Time interval for automatic curve regularisation   0.0001
auto_filter <logical> Automatically filter curves TRUE, FALSE FALSE
auto_filter_class <string> Filter class for automatic filtering of curves C60, C180, C600, C1000 C60


The following strings control the T/HIS header and version number at the bottom right of the plot space

PreferenceTypeDescriptionValid argumentsDefault
user_text_line_1 <string> Text for line 1   <none>
user_text_line_2 <string> Text for line 2   <none>
user_text_line_3 <string> Text for line 3   <none>
user_text_line_4 <string> Text for line 4   <none>
user_text_line_5 <string> Text for line 5   <none>
user_text_line_6 <string> Text for line 6   <none>
user_text_size_1 <string> Size of text on line 1 8, 10, 12, 14, 18, 24, Default Default
user_text_size_2 <string> Size of text on line 2 8, 10, 12, 14, 18, 24, Default Default
user_text_size_3 <string> Size of text on line 3 8, 10, 12, 14, 18, 24, Default Default
user_text_size_4 <string> Size of text on line 4 8, 10, 12, 14, 18, 24, Default Default
user_text_size_5 <string> Size of text on line 5 8, 10, 12, 14, 18, 24, Default Default
user_text_size_6 <string> Size of text on line 6 8, 10, 12, 14, 18, 24, Default Default
user_text_font <string> Font for user text Helvetica_Medium, Helvetica_Bold, Courier_Medium, Courier_Bold, Times_Medium, Times_bold, Default Default
user_text_colour <string> Colour for user text (hex code e.g. 0XA1B2C3 or core colour name e.g. OLIVE) FOREGROUND, WHITE, BLACK, RED, GREEN, BLUE, CYAN, MAGENTA, YELLOW, ORANGE, TURQUOISE, INDIGO, LIME, SKY, PINK, PALE_YELLOW, GOLD, OLIVE, DARK_MAGENTA, MEDIUM_GREEN, MEDIUM_BLUE, HOT_PINK, LIGHT_PINK, SEA_GREEN, MAROON, DARK_GREEN, PURPLE, NAVY, DARK_GREY, MEDIUM_GREY, LIGHT_GREY FOREGROUND


The following control treatment of unicode

PreferenceTypeDescriptionValid argumentsDefault
cjk_unix_font <string> Font to use for CJK text on unix machines   -misc-fixed-medium-r-normal-*-12-*-*-*-*-*-*-*
cjk_windows_font <string> Font to use for CJK text on windows machines   MS Gothic 10
file_encoding <string> Character encoding for script files Latin-1, BIG5, EUC-CN, EUC-JP, EUC-KR, GB, GBK, ISO-2022-CN, ISO-2022-CN-EXT, ISO-2022-JP, ISO-2022-JP-2, ISO-2022-KR, JOHAB, Shift-JIS, UTF-8, UTF-16BE, UTF-16LE, UTF-16, UTF-32BE, UTF-32LE, UTF-32 Latin-1


The following strings and values control the display of UNIT information in T/HIS

PreferenceTypeDescriptionValid argumentsDefault
model_units <string> Sets the default UNIT system for models U1 m:kg:s (SI), U2 mm:T:s, U3 mm:kg:ms, U4 mm:gm:ms, U5 ft:slug:s, U6 m:T:s U1 m:kg:s (SI)
display_units <string> Sets the default UNIT system used to display results U1 m:kg:s (SI), U2 mm:T:s, U3 mm:kg:ms, U4 mm:gm:ms, U5 ft:slug:s, U6 m:T:s U1 m:kg:s (SI)
write_csv_units <logical> Write UNIT information to CSV files TRUE, FALSE TRUE


"oa_pref" arguments valid for all programs

PreferenceTypeDescriptionValid argumentsDefault
file_names <string> Controls input filename syntax. LSTC = d3*, OASYS = job.ptf* OASYS, LSTC OASYS
html_application <string> Location of HTML browser   <none>
html_application_linux <string> Location of HTML browser for linux (use if the same oa_pref file is used for windows and linux)   <none>
html_application_windows <string> Location of HTML browser for windows (use if the same oa_pref file is used for windows and linux)   <none>
image_format <string> Default image format BMP_8_C, BMP_8_UN, PNG_8, GIF_8, BMP_24_UN, PNG_24, JPG_24, PPM_24 PNG_24
intel_hd_use_shaders <string> Control usage of hardware shaders on Intel HD graphics cards AUTO_DETECT, FORCE_OFF, FORCE_ON AUTO_DETECT
javascript_maximum_memory_size <integer> Maximum memory allocated for garbage collection (MB) 1 - 4095 4095
locale <string> Language and country locale to use (overrides system one)   <none>
manuals_url <string> URL of the online manuals   help.oasys-software.com/articles/?readerUiPreview=1#!
maximise <logical> Maximise window when Program is started TRUE, FALSE TRUE
online_manuals <logical> Open the online version of the manuals from Help buttons (TRUE) or open the local (offline) HTML copy (FALSE) TRUE, FALSE TRUE
pdf_application <string> Location of PDF browser   <none>
pdf_application_linux <string> Location of PDF browser for linux (use if the same oa_pref file is used for windows and linux)   <none>
pdf_application_windows <string> Location of PDF browser for windows (use if the same oa_pref file is used for windows and linux)   <none>
placement <string> Location for initial window on multi-screen display LEFT, CENTRE, RIGHT, BOTTOM, TOP, LEFT_BOTTOM, LEFT_TOP, CENTRE_BOTTOM, CENTRE_TOP, RIGHT_BOTTOM, RIGHT_TOP <none>
start_in <string> Directory to start Program in   <none>
temp_file_expiry <integer> Age in days after which a temporary filename can be reused, 0 = never 0 - 10000 31
show_license_warning <logical> Display Window containing License System messages TRUE, FALSE TRUE
post_uses_primer <logical> ADMIN/INSTALL pref which allows D3Plot, T/his to take an available Primer license TRUE, FALSE TRUE
save_window_positions <logical> Save position of undocked windows between sessions TRUE, FALSE TRUE


The following control whether and how crash dump information is sent by email following a crash

PreferenceTypeDescriptionValid argumentsDefault
cd_compose_email <logical> Whether or not to offer to compose an email for sending minidump files. TRUE, FALSE TRUE
cd_email_address <string> Email address in To: field of crash dump emails.   dyna.support@arup,com
cd_cc_addresses <string> Email address(es) in Cc: field of crash dump emails.   <none>
cd_custom_email <string> Custom method of sending emails.   <none>
cd_dump_directory <string> Directory in which to save crash dump files   <none>
cd_email_method <string> Method used to create crash dump emails. BEST_EFFORT, SYSTEM_DEFAULT, OUTLOOK_CLI, URL_MAILTO, CUSTOM BEST_EFFORT
cd_minidump_file <string> Whether or not to create minidump files, and what to do with them. NOT_USED, SAVED_ONLY, EMAILED_ONLY, SAVED_AND_EMAILED SAVED_AND_EMAILED


The following control directories

PreferenceTypeDescriptionValid argumentsDefault
home_dir <string> "home" directory for user   <none>
manuals_dir <string> Directory user manuals are installed in   <none>
temp_dir <string> temporary directory for user   <none>
write_checkpoint_files <logical> Record checkpoint files for the PRIMER, D3PLOT or T/His sessions. TRUE, FALSE FALSE
checkpoint_dir <string> Directory for checkpoint files. If omitted use cwd.   <none>
show_checkpoint_files <logical> Show checkpoint playback panel upon PRIMER, D3PLOT or T/His startup. TRUE, FALSE FALSE


General graphics initialisation and settings.

PreferenceTypeDescriptionValid argumentsDefault
initial_view_orientation <string> Initial view orientation for the graphics window. +XY, +YZ, +XZ, +ISO, -XY, -YZ, -XZ, -ISO +XY


The following options control graphical user interface

PreferenceTypeDescriptionValid argumentsDefault
gui_theme <string> Graphical User Interface (GUI) theme LIGHT, DARK, CLASSIC, LEGACY LIGHT
gui_styling_mode <string> Graphical User Interface (GUI) styling and decoration NOT_USED, TIME_LIMIT, ALWAYS TIME_LIMIT
gui_styling_tlimit <integer> Graphical User Interface (GUI) menu repaint time limit to turn off decorations 0 - 100000 500


The following control laser options

PreferenceTypeDescriptionValid argumentsDefault
laser_paper_size <string> Default paper size US, A4 A4
laser_orientation <string> Default page orientation Portrait, Landscape Landscape
laser_top_margin <real> Top margin size in mm   10
laser_bottom_margin <real> Bottom margin size in mm   30
laser_left_margin <real> Left margin size in mm   20
laser_right_margin <real> Right margin size in mm   10


The following control menu and mouse attributes

PreferenceTypeDescriptionValid argumentsDefault
display_factor <real> Factor on display size (0.5 - 2.0, automatic if undefined) 0.5 - 2.0 1.2
display_brightness <real> Menu brightness (0.0-1.0) 0.0 - 1.0 1.0
display_saturation <real> Menu colour saturation (0.0-1.0) 0.0 - 1.0 1.0
button_gradation <real> Button shade gradation (0.0-1.0) 0.0 - 1.0 0.0
dv_sync_windows <string> Dyn view method(s) for synchronising windows ICON, ICON+CAPS, ICON+NUM, ICON+CAPS+NUM ICON+CAPS
dv_left_shift <string> Dyn view action for shift + Left mouse ROTATION_XYZ, ROTATION_XY, ROTATION_Z, ROTATION_SPHERE, TRANSLATION, ZOOM_UP_+VE, ZOOM_DOWN_+VE, UNUSED ROTATION_XYZ
dv_middle_shift <string> Dyn view action for shift + Middle mouse ROTATION_XYZ, ROTATION_XY, ROTATION_Z, ROTATION_SPHERE, TRANSLATION, ZOOM_UP_+VE, ZOOM_DOWN_+VE, UNUSED TRANSLATION
dv_right_shift <string> Dyn view action for shift + Right mouse ROTATION_XYZ, ROTATION_XY, ROTATION_Z, ROTATION_SPHERE, TRANSLATION, ZOOM_UP_+VE, ZOOM_DOWN_+VE, UNUSED ZOOM_UP_+VE
dv_left_ctrl <string> Dyn view action for ctrl + Left mouse ROTATION_XYZ, ROTATION_XY, ROTATION_Z, ROTATION_SPHERE, TRANSLATION, ZOOM_UP_+VE, ZOOM_DOWN_+VE, UNUSED ROTATION_XYZ
dv_middle_ctrl <string> Dyn view action for ctrl + Middle mouse ROTATION_XYZ, ROTATION_XY, ROTATION_Z, ROTATION_SPHERE, TRANSLATION, ZOOM_UP_+VE, ZOOM_DOWN_+VE, UNUSED TRANSLATION
dv_right_ctrl <string> Dyn view action for ctrl + Right mouse ROTATION_XYZ, ROTATION_XY, ROTATION_Z, ROTATION_SPHERE, TRANSLATION, ZOOM_UP_+VE, ZOOM_DOWN_+VE, UNUSED ZOOM_UP_+VE
dv_left_both <string> Dyn view action for shift+ctrl + Left mouse ROTATION_XYZ, ROTATION_XY, ROTATION_Z, ROTATION_SPHERE, TRANSLATION, ZOOM_UP_+VE, ZOOM_DOWN_+VE, UNUSED ROTATION_XYZ
dv_middle_both <string> Dyn view action for shift+ctrl + Middle mouse ROTATION_XYZ, ROTATION_XY, ROTATION_Z, ROTATION_SPHERE, TRANSLATION, ZOOM_UP_+VE, ZOOM_DOWN_+VE, UNUSED TRANSLATION
dv_right_both <string> Dyn view action for shift+ctrl + Right mouse ROTATION_XYZ, ROTATION_XY, ROTATION_Z, ROTATION_SPHERE, TRANSLATION, ZOOM_UP_+VE, ZOOM_DOWN_+VE, UNUSED ZOOM_UP_+VE
dv_shift_action <string> Dynamic viewing mode for shift + mouse button CURRENT, WIREFRAME, FREE_EDGE, UNUSED CURRENT
dv_ctrl_action <string> Dynamic viewing mode for ctrl + mouse button CURRENT, WIREFRAME, FREE_EDGE, UNUSED WIREFRAME
dv_both_action <string> Dynamic viewing mode for shift+ctrl + mouse button CURRENT, WIREFRAME, FREE_EDGE, UNUSED FREE_EDGE
font_cache <logical> Whether to use cached fonts on Linux machines with no core X11 fonts loaded TRUE, FALSE TRUE
font_quality <string> The quality of font rendering in the graphical user interface PLAIN, ANTI-ALIAS ANTI-ALIAS
font_scaling <string> Whether text in GUI buttons can be scaled down to fit (TRUE means both width and height) FALSE, WIDTH, HEIGHT, TRUE WIDTH
font_silent <logical> whether to write explanatory text if wanted fonts are not found TRUE, FALSE FALSE
font_size <string> Menu font size TINY, SMALL, DEFAULT, LARGE, HUGE DEFAULT
font_type <string> Menu font typeface and strength HELVETICA, HELVETICA-BOLD, TIMES, TIMES-BOLD, COURIER, COURIER-BOLD HELVETICA
unix_prop_font <string> GUI proportional font for menu panels on Linux/Unix   Helvetica
unix_mono_font <string> GUI monospaced font for listing boxes on Linux/Unix   Courier New
windows_prop_font <string> GUI proportional font for menu panels on Windows   Helvetica
windows_mono_font <string> GUI monospaced font for listing boxes on Windows   Courier New
left_handed <string> Left handed switching of mouse and/or keyboard NONE, MOUSE, KEYBOARD, ALL NONE
zoom_factor <real> Zoom Factor for mouse wheel (0.01-1.0) 0.01 - 1.0 0.05
czoom_factor <real> Factor for right mouse dynamic zoom (0.01-0.2) 0.01 - 0.2 0.05
kzoom_factor <real> Factor for +/- keyboard short-cut keys 0.01 - 100.0 2.0
menu_dragging_mode <string> Mode used when moving menu panels with the mouse WIREFRAME, OPAQUE WIREFRAME
mouse_3d_rotation_factor <real> Factor applied to the speed of rotation when using a 3D mouse   1.0
mouse_3d_pan_factor <real> Factor applied to the speed of panning when using a 3D mouse   1.0
mouse_3d_zoom_factor <real> Factor applied to the speed of zooming when using a 3D mouse   1.0
mouse_action_middle_button <string> Set the action for the middle mouse key during picking APPLY, REJECT, DESELECT REJECT
mouse_action_right_button <string> Set the action for the right mouse key during picking APPLY, REJECT, DESELECT DESELECT


The following control treatment of recent files popups

PreferenceTypeDescriptionValid argumentsDefault
recent_files_dropdown <string> Turn the recent files popup on or off OFF, ON ON
recent_files_max_but <integer> Maximum number of buttons displayed in a recent files popup 1 - 50 10
recent_files_max_char <integer> Maximum number of characters displayed on each recent files button 1 - 512 50


The following control treatment of unicode

PreferenceTypeDescriptionValid argumentsDefault
cjk_unix_font <string> Font to use for CJK text on unix machines   -misc-fixed-medium-r-normal-*-12-*-*-*-*-*-*-*
cjk_windows_font <string> Font to use for CJK text on windows machines   MS Gothic 10
file_encoding <string> Character encoding for script files Latin-1, BIG5, EUC-CN, EUC-JP, EUC-KR, GB, GBK, ISO-2022-CN, ISO-2022-CN-EXT, ISO-2022-JP, ISO-2022-JP-2, ISO-2022-KR, JOHAB, Shift-JIS, UTF-8, UTF-16BE, UTF-16LE, UTF-16, UTF-32BE, UTF-32LE, UTF-32 Latin-1


The drive mappings allow PRIMER to convert equivalent folder names from Windows to Unix and visa versa. This is currently only in use for the JavaScript function DriveMapFilename for D3PLOT and T/HIS.

PreferenceTypeDescriptionValid argumentsDefault
drive_a <string> Mapping from Windows drive A: to unix path   <none>
drive_b <string> Mapping from Windows drive B: to unix path   <none>
drive_c <string> Mapping from Windows drive C: to unix path   <none>
drive_d <string> Mapping from Windows drive D: to unix path   <none>
drive_e <string> Mapping from Windows drive E: to unix path   <none>
drive_f <string> Mapping from Windows drive F: to unix path   <none>
drive_g <string> Mapping from Windows drive G: to unix path   <none>
drive_h <string> Mapping from Windows drive H: to unix path   <none>
drive_i <string> Mapping from Windows drive I: to unix path   <none>
drive_j <string> Mapping from Windows drive J: to unix path   <none>
drive_k <string> Mapping from Windows drive K: to unix path   <none>
drive_l <string> Mapping from Windows drive L: to unix path   <none>
drive_m <string> Mapping from Windows drive M: to unix path   <none>
drive_n <string> Mapping from Windows drive N: to unix path   <none>
drive_o <string> Mapping from Windows drive O: to unix path   <none>
drive_p <string> Mapping from Windows drive P: to unix path   <none>
drive_q <string> Mapping from Windows drive Q: to unix path   <none>
drive_r <string> Mapping from Windows drive R: to unix path   <none>
drive_s <string> Mapping from Windows drive S: to unix path   <none>
drive_t <string> Mapping from Windows drive T: to unix path   <none>
drive_u <string> Mapping from Windows drive U: to unix path   <none>
drive_v <string> Mapping from Windows drive V: to unix path   <none>
drive_w <string> Mapping from Windows drive W: to unix path   <none>
drive_x <string> Mapping from Windows drive X: to unix path   <none>
drive_y <string> Mapping from Windows drive Y: to unix path   <none>
drive_z <string> Mapping from Windows drive Z: to unix path   <none>


The following control workflows functionality

PreferenceTypeDescriptionValid argumentsDefault
workflow_definitions_directory <string> Location that will be scanned for Workflow definitions   <none>
workflow_only_use_specified_directory <logical> Only scan location set by preference oasys*workflow_definitions_directory for Workflow definitions (if it is set) TRUE, FALSE FALSE
workflow_user_data_directory_name <string> Name of a folder to search in for workflow user data   <none>
workflow_auto_open_post_menu <logical> Automatically open the Workflow menu in D3PLOT or T/HIS when reading in a model that has workflow data TRUE, FALSE FALSE
workflow_max_upward_folder_search_depth <integer> Maximum number of folders to search up to look for workflow user data 0 - 100 4