Nodal results program
timex is a command-line program to interrogate the completed results at specified points and get temperature histories from thermal simulations or stress, strain, as well as distortion histories from mechanical results. For points not associated with model nodes, values are linearly interpolated. This program works for both moving-source and part-scale simulations.
Jump to:
Input file format
The input file, input-example.txt, is a text file of the following format:
*INPU: Netfabb simulation input file name, without .in extension
a1: Input file name
*OUTP: Output file name
a1: Input file name
Default: timexn*INPU_.txt
*IOFF: Increment specification
By default timex will export results for all timesteps. Use *IOFF to specify one timestep to output. Range [-<ninc>, -1] or [1, <ninc>], where <ninc> is the number of solver increments with results. Negative *IOFF counts backwards from the end of the analysis, and positive *IOFF counts forwards from the beginning. For convenience, output data for each point is separated by a linefeed, as opposed to the usual one-line-per-timestep behavior.
*PNTS: Number of points and point coordinates
i1: number of points
r11, r12, r13 : X1, Y1, Z1 coordinates
r21, r22, r23 : X2, Y2, Z2 coordinates
...
*PREC: Decimal digit precision for output
il: precision
Set the precision for the output file. Default value is 6 digits.
*SNAP: Snap probe points to closest element
Without using *SNAP, points outside of active elements return 0 results until a containing element is activated. With snap, probe points are snapped to the closest element in terms of local coordinates. By default snapping is off.
*VOXL: Disable fast voxel search
il: 0 to disable, any non-zero value to enable (default for non-Patran). Default enabled for automatic meshes, always disabled for Patran meshes.
*RESU: Number of result components
*RESU i1 a1
i1: Number of result components: 1 for scalar, 3 for vector, or 6 for symmetric tensor.
a1: Result file extension name. See the table below.
By default, without using *RESU, timex run on a thermal analysis will return the temperature history, while a mechanical file will return the displacement history. To override this, specify tensor order i1 and the file extension a1.
| Result card | File extension | Description (tensor order) |
|---|---|---|
| OSIG | .sig.ens | Cauchy stress (6) |
| OEPT | .ept.ens | Elastic strain (6) |
| OEQP | .eqp.ens | Equivalent plastic strain (1) |
| OMLT | .mlt.ens | Melt indicator (1) |
| OEPP | .epp.ens | Plastic strain (6) |
| OSD3 | .sd[123].ens | Principal stress directions (3) |
| OSP3 | .sp[123].ens | Principal stress values (3) |
| OSVM | .svm.ens | von Mises stress (1) |
| q@"J | .tmp.ens | Temperature (1) |
For a default case example, having run a simulation using the file test_input.in, the user extracts the temperature or stress and distortion history at 3 points in a vertical column:
*INPU test input *PNTS 3 5, 5, 0 5, 5, 2 5, 5, 4
To extract the Cauchy Stress Tensor at the same location, the timex input file would be:
*INPU test input *PNTS 3 5, 5, 0 5, 5, 2 5, 5, 4 *RESU 6 sig.ensTop
Additional options for multi-layer adaptivity
For Multilayer adaptivity simulations, two additional cards need to be added to the timex input file, *CRSE and *SHFT.
*CRSE: Coarse Case File
This card tells timex to access the coarse instead of fine case file.
*SHFT: Shift to Multilayer Adaptivity
This card tells timex to shift to the multilayer adaptivity node inquisition scheme.
Top