Showcase Overview

Showcases are complete, runnable examples for the eMachineSim Python API. They are intended for users who want to start from validated sample data rather than from isolated API calls.

Use this page to choose the example closest to your analysis goal.

Available Showcases

Thermal Quick Cases

Small thermal/BDF examples for first-time verification and daily smoke tests. These cases cover CHEXA, CPENTA, and CTETRA BDF import, QVOL volume heat, PSOLID/MAT diagnostics, JSON total_heat, JSON heat_density, and closed heat balance checks.

Start here if you want the smallest possible thermal examples.

Examples/thermal/bdf/

Realistic Motor Steady Thermal Sample

A motor-like steady thermal analysis based on QVOL_loss_mix.bdf. This example combines BDF QVOL loss, JSON coil copper loss, JSON permanent-magnet loss, FEMH external cooling, thermal equivalent circuits, stator/rotor gap thermal coupling, surface assignment diagnostics, component heat balance, and cooling path summaries.

Start here if you want the main motor thermal workflow.

Examples/thermal/realistic_motor_steady/

Structural Rotor Samples

Rotor-oriented structural static examples. These samples demonstrate 2D rotor structural analysis, centrifugal loading, shaft/boundary-condition variants, contact-oriented diagnostics, displacement post files, and structural load balance outputs.

Start here if you want static stress/deformation examples.

Examples/structural/rotor/

Motor NVH Samples

Modal and simplified motor NVH examples based on a stator model. These samples cover modal analysis, sparse eigenvalue solving, nodal force import, force mapping, modal superposition frequency response, outer normal velocity, circumferential order decomposition, and simplified cylindrical acoustic indicators.

Start here if you want vibration and relative acoustic-risk examples.

Examples/structural/modal_stator/

Electrostatic Samples

Small electrostatic examples for the current electric-field workflow. The electrostatic feature set is currently a smaller sample path, but it is kept in the public documentation because electric/electrostatic extensions are expected to grow in future releases.

Start here if you want to check the electrostatic solver path.

Examples/electrostatic/3by3/
Examples/electrostatic/ring/

Choosing a Showcase

Goal	Recommended page
Verify installation quickly	Thermal Quick Cases
Learn the main motor thermal workflow	Realistic Motor Steady Thermal Sample
Run static rotor stress/deformation	Structural Rotor Samples
Run modal or motor NVH workflows	Motor NVH Samples
Run an electrostatic sample	Electrostatic Samples

What Each Showcase Explains

Each showcase should identify:

• input JSON files,
• mesh or sample data,
• physics or analysis purpose,
• loads, losses, or boundary conditions,
• expected CSV diagnostics,
• post-processing files,
• heat/load/frequency balance checks where applicable,
• current limitations.

Visualization Files

Showcase examples include ParaView-readable legacy VTK files where post data is available. Typical files are:

File	Used by
mesh.vtk	Mesh geometry for thermal, electrostatic, structural, and modal samples.
thermal_result.vtk	Thermal temperature and field visualization.
electric_result.vtk	Electrostatic potential and electric-field visualization.
structural_displacement.vtk	Static structural displacement and von Mises visualization.
modal_modes.vtk	Modal mode-shape visualization.
boundary_faces.vtk	Boundary surface visualization.

These VTK files are written automatically by the relevant post-processing path; the public examples keep representative outputs so the showcase pages can be read together with visual data.