<output>
The <output> category specifies the main parameters for various types of simulation output.
Full Data | Surface | Section Cut | Partial Surface | Partial Volume | |
---|---|---|---|---|---|
pressure | Default | Default | Default | Default | Default |
time_avg_pressure | Default | Default | Default | Optional | Optional |
window_avg_pressure | Optional | Optional | Optional | Optional | Optional |
velocity | Default | Default1 | Default | Optional1 | Default |
time_avg_velocity | Default | N.A. | Default | N.A. | Optional |
window_avg_velocity | Optional | N.A. | Optional | N.A. | Optional |
wall_shear_stress | Default | Default | N.A. | Default | N.A. |
time_avg_wall_shear_stress | Default | Default | N.A. | Optional | N.A. |
window_avg_wall_shear_stress | Optional | Optional | N.A. | Optional | N.A. |
density | Optional | Optional | Optional | Optional | Optional |
time_avg_density | Optional | Optional | Optional | Optional | Optional |
window_avg_density | Optional | Optional | Optional | Optional | Optional |
surface_normal | Default | Default | N.A. | Optional | N.A. |
mesh_data | Default | N.A. | N.A. | N.A. | N.A. |
1The surface velocity is 0 on static surfaces and non-zero if a wall velocity is prescribed using the <boundary_condition> - <rotating> section.
<output> - <general>
- <output_frequency>
- Specifies the number of coarsest iterations between consecutive outputs of the volume and the surface data in EnSight Gold format. You can specify fractions of 1 to obtain an output at the desired sub-time step level.
- <output_start_iteration>
- Specifies after which coarsest iteration the output will start.
- <merge_output_files>
- Specifies if the output files written in a partitioned way per MPI rank are merged into single files after the simulation is complete. The individual files per MPI rank are not deleted by this operation, so the data size of the output is effectively doubled. H3D or EnSight files will be merged, depending on the file format specified.
- <saved_states>
- Specifies the number of consecutive output files to be kept, that is, if set to 2, the latest two output time steps are kept while the rest are removed. If set to zero, the feature is deactivated and all output time steps are kept.
- <avg_start_coarsest_iteration>
- Specifies after which coarsest iteration the continuous averaging of variables and force coefficients starts. The averaging itself also uses information from subiterations on the finer refinement levels.
- <file_format>
- Option to define whether the output should be in EnSight Gold, H3D, or both formats. <ensight> true/false, <h3d> true/false.
- <avg_window_size>
- Specifies the number of consecutive coarsest iterations that will be used for window averaging. This value should be a factor of <output_frequency>.
- <output_variables_full>
- In this section, you can specify which of the variables listed in Table 1
should or should not be included in the full data output by setting
<variable_name> to true or false.Note: The default case is to export all variables, thus it is not required to explicitly set the variables to “true”; if not mentioned in this section, the variables are still written. To omit a variable from being written, you have to specifically set the corresponding solver deck entry to “false”.
- <output_variables_surface>
- In this section, you can specify which of the variables listed in Table 1
should be included and which should be excluded in the surface data
output by setting <variable_name> to true or false.Note: The default case is to export all variables, thus it is not required to explicitly set the variables to “true”; if not mentioned in this section, the variables are still written. To omit a variable from being written, you have to specifically set the corresponding solver deck entry to “false”.
<output> - <moment_reference_system>
This category specifies the properties of the moment reference system that is used to calculate the aerodynamic forces in a body-fixed coordinate system and also to calculate the pitch moment to be able to split the lift into front and rear part. The moment reference system is defined according to automotive aerodynamics conventions and needs to be placed in the center of the four support points defined by the wheel positions (in general on the ground plane).
As reference length, you need to indicate the wheel base (the distance between front and rear axle).
- <origin>
- The origin of the moment reference system, must be specified via the child parameters <x_pos>, <y_pos> and <z_pos> in .
- <roll_axis>
- The roll axis of the moment reference system, must be specified via the child parameters <x_dir>, <y_dir> and <z_dir>.
- <pitch_axis>
- The pitch axis of the moment reference system, must be specified via the child parameters <x_dir>, <y_dir> and <z_dir>.
- <yaw_axis>
- The yaw axis of the moment reference system, must be specified via the child parameters <x_dir>, <y_dir> and <z_dir>.
<output> - <aero_coefficients>
This category specifies the properties that are connected to the output of the aerodynamic coefficients.
By default, the instantaneous and averaged aerodynamic coefficients are recorded at every coarsest iteration in the files uFX_coefficients_Inst.txt and uFX_coefficients_Avg.txt in the uFX_coefficientsData folder.
- <reference_area>
- The reference area used to calculate the aerodynamic coefficients (drag, lift, side force) in .
- <reference_area_auto>
- Specifies if the value of <reference_area> should be used (false) or if the reference area (the frontal projection area) should be automatically calculated by ultraFluidX itself (true).
- <reference_length>
- The reference length (in ) that is used to calculate the pitch moment to be able to subsequently calculate the front and rear lift coefficients. See <output> - <moment_reference_system>.
- <passive_parts>
- If certain parts of the geometry should be excluded from the calculation of the aerodynamic coefficients, they can be specified via the child parameter <name> within this category. The specified names must match the respective part names in the STL file.
- <coefficients_parts>
- Specifies if the aerodynamic coefficients should also be output by part. If set to true (default value), ultraFluidX will create the files uFX_coefficientsPerPart_Inst.txt and uFX_coefficientsPerPart_Avg.txt in the output folder containing the whole list of parts per time step and a subfolder named uFX_coefficientsPerPart, where one individual file per part (uFX_coefficients_#PARTNAME_Inst.txt, uFX_coefficients_#PARTNAME_Avg.txt) will be recorded.
- <coefficients_along_axis>
- Specifies the number of sections along the x-, y- and z-direction of the object that should be used for the sectional coefficient output.
- <forces_and_moments_export>
- If set to true, the aerodynamic forces and moments will be exported in SI units. For each file uFX_coefficients*.txt, a corresponding file uFX_forcesAndMoments*.txt will be written. This includes the respective files for <coefficients_parts> and <coefficients_along_axis> if they are activated. The default value for <forces_and_moments_export> is false.
- <output_start_iteration>
- (Optional) Specifies when to start the coefficient output (coarsest iteration). The default value is 0.
<output> - <section_cut>
This category specifies section cuts on which field variables should be output independent from the general variable output. The same conventions apply for the EnSight Gold files and ultraFluidX will create a subfolder named uFX_sectionCuts, where the output of each section cut will be stored in a separate folder.
- <name>
- Name of the instance, used to create the respective subfolder in uFX_sectionCuts (mandatory).
- <axis>
- Normal axis of the instance, its direction must be specified via the child parameters <x_dir>, <y_dir> and <z_dir>. Currently, only section cuts normal to any global axis are supported.
- <point>
- Point on the instance, its coordinates must be specified via the child parameters <x_pos>, <y_pos> and <z_pos> in .
- <bounding_box>
- Bounding box of the instance, must be specified via the child parameters <x_min>, <x_max>, <y_min>, <y_max>, <z_min> and <z_max> in .
- <output_frequency>
- Specifies the number of coarsest iterations between consecutive outputs. Fractions of 1 are allowed to get an output at the desired sub-time step level.
- <output_start_iteration>
- (Optional) Specifies when to start the section cut output (coarsest iteration) for each section cut instance. Can be used to generate high-frequency output for a specific part of the domain once the initial transient phase is completed. The default value is 0.
- <triangulation>
- By default, the value is false and all section cuts are exported using “nsided” elements. If set to true, the respective section cut instance is exported using “tria3” elements instead.
- <output_variables>
- (Optional) In this section, you can specify which variables should be included in the section cut output by setting <variable_name> to true or false. The possible options are listed in Table 1.
<output> - <partial_surface>
This category specifies parts on which surface variables should be output independent from the general variable output. The same conventions apply for the EnSight Gold files and ultraFluidX will create a separate folder in the subfolder named uFX_surfaceData, where the output of each part will be stored.
The category can have an arbitrary number of children named <partial_surface_instance>, each with the following parameters:
- <name>
- (Optional) Name of the instance.
- <parts>
- The part(s) on which the surface variables should be output, must be specified with the parameter <name> within the <parts> category. Several parts with the same output behavior can be specified via repeated usage of <name>. The specified names must exactly match the respective part names in the STL file.
- <output_frequency>
- Specifies the number of coarsest iterations between consecutive outputs. You can specify fractions of 1 to obtain an output at the desired sub-time step level.
- <output_start_iteration>
- (Optional) Specifies when to start the partial surface output (coarsest iteration) for each partial surface instance. Can be used to generate high-frequency output for a specific part of the domain, once the initial transient phase is completed. The default value is 0.
- <output_variables>
- In this section, you can specify which variables should be included in the section cut output by setting <variable_name> to true or false. The possible options are listed in Table 1.
<output> - <partial_volume>
- <name>
- Name of the instance, used to create the respective folder (mandatory).
- <bounding_box>
- Bounding box of the instance, must be specified via the child parameters <x_min>, <x_max>, <y_min>, <y_max>, <z_min> and <z_max> in .
- <output_frequency>
- Specifies the number of coarsest iterations between consecutive outputs. You can specify fractions of 1 to obtain an output at the desired sub-time step level.
- <output_start_iteration>
- Specifies when to start the partial volume output (coarsest iteration) for each partial volume instance. Can be used to generate high-frequency output for a specific part of the domain, once the initial transient phase is completed. The default value is 0.
- <output_variables>
- In this section, you can specify which variables should be included in
the section cut output by setting
<variable_name> to true or false. The
possible options are listed in Table 1. Note: If no variables are chosen explicitly, the full set will be exported; otherwise, only the variables that are indicated in this section are written.
<output> - <single_probe>
This category specifies single probes, where instantaneous surface data or volume data should be output independent from the general variable output. The files are stored in the uFX_probeData folder. Each probe creates one .csv file per output variable, plus an additional file that contains the probe locations (uFX_volumeProbes_***_location.csv and uFX_surfaceProbes_***_location.csv).
- <name>
- (Mandatory) Name of the instance used to create the respective file or subfolder.
- <x_pos>, <y_pos>, <z_pos>
- Respective coordinate of the probe in .
- <type>
- Specifies if data from the nearest voxel (volume) or from the nearest surface triangle (surface) should be output.
- <radius>
- Specifies the radius [m] of a fictitious sphere whose containing data sources are used to determine the mean value(s) of the requested variable(s).
- <output_frequency>
- Specifies the number of coarsest iterations between consecutive outputs. Fractions of 1 are allowed to get an output at the desired sub-time step level.
- <scientific_notation>
- If set to true, the output files are written in scientific notation. If set to false, the output files are written in conventional decimal notation instead.
- <output_precision>
- In combination with scientific notation (default), the output includes eight significant digits. Using this parameter, you can choose an arbitrary value.
- <output_variables>
- In this section, you can specify which variables should be included in the probe output by setting <variable_name> to true or false. The possible options depend on the probe type:
- <output_start_iteration>
- (Optional) Specifies when to start the output (coarsest iteration) for each single probe instance.
<output> - <probe_file>
This category specifies probe files containing multiple locations where instantaneous surface data or volume data should be output independent from the general variable output.
The files are stored in the uFX_probeData folder. Each probe file instance will create one .csv file per output variable, plus an additional file that contains the probe locations (uFX_volumeProbes_***_location.csv and uFX_surfaceProbes_***_location.csv).
Depending on the type of the probe file, ultraFluidX will either create a single *.csv file containing the transient Cp data (surface probes, uFX_surfaceProbes_#NAME.csv) or multiple *.csv files containing pressure, velocity magnitude and velocity component data (volume probes, uFX_volumeProbes_#NAME_Variable_Name) for recording the data.
- <name>
- Name of the instance, used to create the respective file(s) or subfolder (mandatory).
- <source_file>
- Source file containing the probe locations in *.csv
format without header, each line defines a probe with the coordinates in
, which must be separated by semicolons:
x_pos;y_pos;z_pos;Description_A
x_pos;y_pos;z_pos;Description_B
- <type>
- Specifies if data from the nearest voxel (volume) or from the nearest surface triangle (surface) should be output for each probe location.
- <radius>
- Specifies the radius [m] of a fictitious sphere whose containing data sources are used to determine the mean value(s) of the requested variable(s).
- <output_frequency>
- Specifies the number of coarsest iterations between consecutive outputs. Fractions of 1 are allowed to get an output at the desired sub-time step level.
- <scientific_notation>
- If set to true, the output files are written in scientific notation. If set to false, the output files are written in conventional decimal notation instead.
- <output_precision>
- Using this parameter, you can choose an arbitrary integer value.
- <output_variables>
- In this section, you can specify which variables should be included in the probe output by setting <variable_name> to true or false. The possible options depend on the probe type:
- <output_start_iteration>
- (Optional) Specifies when to start the probe output (coarsest iteration) for each probe file instance. The default value is 0.
<output> - <monitoring_surface>
This category specifies monitoring surfaces, which are arbitrarily shaped, user-defined surfaces for additional post-processing. Monitoring surfaces can be used for the additional visual output of flow field quantities on the respective surface, or for the output of integral values in a summary file.
The files are stored in the uFX_monitoringSurface folder.
- <name>
- Name of the instance (mandatory).
- <parts>
- The part(s) which define the monitoring surface. Must be specified with the parameter <name> within the <parts> category. Several parts can be specified via repeated usage of <name>. The specified names must exactly match the respective part names in the STL file.
- <visual_output>
-
- <output_frequency>
- Specifies the number of coarsest iterations between consecutive outputs. You can specify fractions of 1 to obtain an output at the desired sub-time step level.
- <output_start_iteration>
- Specifies when to start the visual output (coarsest iteration) for each instance. The default value is 0.
- <output_variables>
- In this section, you can specify which variables should be
included in the visual output by setting
<variable_name> to true or
false. The possible options include:
- pressure
- time_avg_pressure
- window_avg_pressure
- velocity
- time_avg_velocity
- window_avg_velocity
- mass_flow
- time_avg_mass_flow
- window_avg_mass_flow
- normal_velocity
- time_avg_normal_velocity
- window_avg_normal_velocity
- density
- time_avg_density
- window_avg_density
- <summary_output>
-
- <output_frequency>
- Specifies the number of coarsest iterations between consecutive outputs. You can specify fractions of 1 to obtain an output at the desired sub-time step level.
- <output_start_iteration>
- Specifies when to start the summary output (coarsest iteration) for each instance. The default value is 0.
- <output_variables>
- In this section, you can specify which variables should be
included in the summary output by setting
<variable_name> to true or
false. The possible options include:
- pressure
- time_avg_pressure
- window_avg_pressure
- mass_flow
- time_avg_mass_flow
- window_avg_mass_flow
- normal_velocity
- time_avg_normal_velocity
- window_avg_normal_velocity