Output Files and Diagnostics

eMachineSim writes a mix of CSV diagnostics and post-processing files. CSV files are intended for scripted checks, while .atl, .neu, .vtk, .mm, and plain output files are intended for visualization, matrix inspection, or debugging.

Thermal CSV Files

CSV file	Purpose
thermal_bdf_import_summary.csv	BDF grid, element, QVOL, property, and section statistics.
thermal_bdf_property_material_summary.csv	BDF PSOLID/MAT diagnostics and analysis material source.
thermal_bdf_element_type_summary.csv	Element-type statistics for CHEXA/CPENTA/CTETRA by section/property.
thermal_volume_heat_sources.csv	JSON volume heat-source details and assigned heat.
thermal_fem_volume_heat.csv	BDF QVOL heat, JSON heat, and total FEM volume heat.
thermal_femh_ports.csv	FEMH surface-to-network port heat flow.
thermal_network_balance.csv	Thermal-network node and element balance.
thermal_global_heat_balance.csv	Global heat balance and residual.
thermal_component_heat_balance.csv	Per-mesh-component heat balance and representative temperatures.
thermal_surface_assignment_summary.csv	Surface overlap and unassigned external area diagnostics.
thermal_surface_temperature_summary.csv	Area-weighted surface temperature diagnostics.
thermal_cooling_path_summary.csv	FEMH, gap coupling, and other cooling path conductance/flow summary.

Thermal Gap and Surface Coupling CSV Files

CSV file	Purpose
thermal_gap_pair_summary.csv	Face-pairing quality summary.
thermal_gap_face_pairs.csv	Face-by-face pairing diagnostics.
thermal_gap_coupling_summary.csv	Assembled coupling conductance and equivalent resistance.
thermal_gap_coupling_flows.csv	Pair-level heat flow after solving.
thermal_gap_coupling_flow_summary.csv	Total gap heat flow and pair heat statistics.
thermal_gap_h_model_summary.csv	Effective heat-transfer coefficient model diagnostics.

Thermal Post Files

File	Purpose
mesh.vtk	Unstructured-grid mesh export for ParaView and other VTK readers. Written automatically.
thermal_result.vtk	Thermal result visualization with temperature, thermal-gradient/field arrays, and element field arrays. Written automatically for thermal runs.
thermal.atl	ATLAS-style thermal result output.
post_geom.atl	Post-processing geometry.
boundary_faces.vtk	Boundary face visualization.
matrix.mm, RHS.mm, solution.mm	Matrix Market debug outputs when enabled.
output, solution	Plain-text solver/result outputs.

Structural Static Output Files

Representative files from Examples/structural/rotor:

File	Purpose
structural_load_balance.csv	Structural load/reaction balance diagnostic.
contact_state.csv	Contact state by contact entity.
contact_penalty_assembly.csv	Contact penalty assembly diagnostic.
mesh.vtk	Unstructured-grid mesh export for ParaView and other VTK readers. Written automatically.
structural_displacement.vtk	Structural displacement visualization with displacement, displacement_magnitude, and von_mises arrays. Written automatically for static structural runs.
contact_debug.vtk	Contact visualization output.
boundary_faces.csv, boundary_faces.vtk	Boundary face diagnostics and visualization.
displacement.atl, displacement.neu	Displacement post-processing results.
post_geom.atl, post_geom.neu, pre_geom.neu	Geometry files for pre/post processing.
matrix.mm, RHS.mm, solution.mm	Matrix Market debug outputs when enabled.
output, solution	Plain-text solver/result outputs.

Modal / Motor NVH Output Files

Representative files from Examples/structural/modal_stator:

File	Purpose
modal_frequencies.csv	Natural frequencies and modal metadata.
modal_modes.csv	Modal displacement data.
mesh.vtk	Unstructured-grid mesh export for ParaView and other VTK readers. Written automatically.
modal_modes.vtk	Mode-shape visualization with vector and magnitude arrays such as mode_001_displacement. Written automatically for modal runs.
modal_modes_cyclic_full.vtk	Cyclic full-circle mode-shape visualization generated from the rotational sector model. Includes sector_id and per-mode cyclic sign arrays.
modal_cyclic_full_expansion.csv	Per-mode cyclic expansion sign diagnostics used by modal_modes_cyclic_full.vtk.
modal_modes.neu	Sector-model mode-shape visualization output.
mass.mm, matrix.mm, RHS.mm	Matrix Market debug outputs when enabled.
motor_nvh_nodal_force_summary.csv	Imported/mapped nodal force summary.
motor_nvh_nodal_force_nodes.csv	Nodal force mapping node table.
motor_nvh_force_circumferential_orders.csv	Circumferential order decomposition of force.
motor_nvh_frequency_response_summary.csv	Modal superposition frequency-response summary.
motor_nvh_modal_participation.csv	Modal contribution diagnostic.
motor_nvh_outer_velocity.csv	Outer boundary normal velocity spectrum.
motor_nvh_outer_velocity_summary.csv	Outer velocity peak/summary diagnostics.
motor_nvh_circumferential_orders.csv	Circumferential order decomposition of response velocity.
motor_nvh_acoustic_radiation_summary.csv	Simplified acoustic-radiation indicator summary.
motor_nvh_acoustic_order_contributions.csv	Order-by-order acoustic contribution diagnostic.
motor_nvh_acoustic_radiation_peaks.csv	Peak list for acoustic indicator output.
motor_nvh_acoustic_radiation_warning.txt	Warnings about simplified acoustic assumptions.
post_geom.atl, post_geom.neu	Geometry post files for sector-model visualization.

Electrostatic Output Files

Electrostatic examples are smaller workflows. Typical outputs may include:

File	Purpose
output	Plain-text solver output.
solution	Scalar potential or solution vector output.
mesh.vtk	Unstructured-grid mesh export for ParaView and other VTK readers. Written automatically.
electric_result.vtk	Electrostatic result visualization with potential, electric-field arrays, and element field arrays. Written automatically for electrostatic runs.
boundary_faces.vtk	Boundary face visualization.
post_geom.neu or related geometry files	Post-processing geometry when enabled by the sample.
matrix/debug files	Optional debug outputs when matrix printing is enabled.

VTK Visualization Notes

VTK post files are written automatically by the current analysis outputs; no additional input parameter is required. Open the .vtk files in ParaView to inspect meshes, boundary faces, temperature, potential, displacement, von Mises stress, or mode-shape arrays depending on the analysis type.

First Checks After a Run

1. Confirm the analysis-specific balance CSV is consistent.
2. Confirm expected post files were written.
3. For thermal cases, confirm thermal_global_heat_balance.csv has a small relative residual.
4. For structural cases, inspect displacement post files and load/contact diagnostics.
5. For NVH cases, inspect modal frequencies first, then response and acoustic indicator CSV files.