TerreLenz — Capabilities: every feature and its limits

● Supported ◐ Supported with the limit stated ○ Not yet (on the roadmap or out of scope)

Model types and physics

What it solves.

Capability		What is supported, and the limit
2D planar models	●	A cross-section extruded by a depth; every study type, rotation, stroke, sectors and periods, circuits and netlists.
2D axisymmetric models	●	x is the radius, y the axis; solenoids, plungers, pot cores, loudspeakers. Stroke along the axis; no rotation (nothing to turn).
3D models	●	Solids from shapes, sketches, STEP, IGES, STL and extruded DXF. Magnetostatic, AC and transient studies, electric studies and heating.
Magnetostatics	●	Nonlinear B-H curves, magnets with demagnetization knees, coils and magnets together; at several rotor positions, stroke positions and current levels in one run.
AC (time-harmonic)	◐	Eddy currents in solid conductors, skin and proximity effects, complex permeability, losses per body, impedance. 2D: saturation by an effective B-H curve (fundamental only). 3D AC is linear.
Transient	◐	Time stepping with eddy currents, saturation, circuits and rotation in 2D, fixed or adaptive steps, start from zero field or from the AC steady state, end at steady state. 3D: coils on current or voltage sources with series R, L and C, eddy currents and saturation, fixed steps; no switches, netlist or motion.
Electrostatics	●	2D and 3D: terminals at voltages or floating, dielectrics, space charge; capacitance matrix, charges, peak field and breakdown margin, forces, a partial-discharge check along field lines (Paschen).
DC and AC current flow	●	2D and 3D: steady or sinusoidal current between terminals; resistance, conductance and admittance matrices, current density, Joule and dielectric losses; the Joule losses as heat sources.
Heating	◐	2D and 3D temperatures from copper, eddy-current, iron and Joule losses, steady state or in time, fed back into the magnetic solve (resistivity, magnets). Conduction in solids; air gaps do not conduct.
Magnetizing	●	A transient that magnetizes magnets element by element with the fixture's field; the map is saved and applied to magnets in another model (2D and 3D maps).
Several studies per project	●	Named studies with their own settings and inputs, solved together and compared; linked models that share parameters.
Linear and small-signal solves	●	Every material linear at a click (how much saturation matters); 2D AC small-signal solve about a DC bias with linearized B-H curves (biased chokes, saturable reactors).

Geometry and CAD

Building and importing models.

Capability		What is supported, and the limit
Basic shapes	●	2D: rectangle, disk, ring, polygon. 3D: box, cylinder, sphere, tube, cone, torus, regular prism and pyramid, placed by sizes and position; name and material given at creation.
Sketching	●	Lines, arcs, circles, slots, equation curves; dimensions and constraints (horizontal, vertical, equal, tangent, …); mirror and linear or circular patterns; every closed region a body. 3D: sketch on a plane or a flat face, extrude or revolve by a number or a parameter.
Transforms	●	Move, rotate, mirror, scale, with copies; groups that move together; each body's own origin and axes; measuring between points, edges and faces.
Booleans and features	●	Unite, subtract, intersect (the tool kept parametric), split by a plane, fillets and chamfers (also on one picked edge, variable along a chain), hollow to a wall, thicken a face, revolve a face, sweep a face along a path with twist, loft through sections.
Build history	●	Every body keeps the steps that built it; each argument can follow a design parameter, so the model rebuilds when parameters change.
STEP, IGES, STL import	●	3D: one body per solid, part names kept, the air region made. Re-import after a design change keeps materials, magnets, coils, mesh sizes and group and rotor membership by name.
DXF import and export	●	2D: each closed region a body, named by layer; 3D: extruded or revolved. Export of a 2D model's outlines, a layer per body.
STEP export	●	The bodies as named parts in millimeters, for CAD.
Geometry checks and clean-up	●	Invalid shapes, overlaps, thin gaps and tiny faces reported before meshing; small details (holes, fillets, small faces) removed below a size.
Symmetry cut	●	Halve the model at x, y or z = 0 with that plane as a symmetry boundary; results count the whole device.
2D model from a 3D section	●	Cut a 3D model with a plane and make a planar or axisymmetric project of the section, with its materials and coils.
Parts from other projects	●	Insert another project's bodies as one group with their materials, coils and parameters.

Materials and magnets

The library and your own data.

Capability		What is supported, and the limit
Material library	◐	Magnets (129 NdFeB, SmCo, ferrite, bonded and alnico grades fitted to grade tables and measured lots), soft magnetic steels and alloys, electrical steels, conductors, ferrites and powder cores, structural and dielectric materials. The soft materials are generic approximations: enter data-sheet curves for design work.
Nonlinear B-H curves	●	Tables typed or pasted, checked and repaired (monotonic, extended to saturation), fitted to measured points or made from Bs and μi; the stack's curve from the stacking factor.
Iron losses	◐	Hysteresis, eddy-current and excess coefficients fitted to loss figures, per harmonic; cut-edge degradation; a calibration factor. Minor loops and DC bias are not modeled.
Magnets	●	Remanence, recoil permeability, demagnetization knee and full demagnetization curves, temperature coefficients; parallel, radial, circumferential, Halbach and spherical magnetization patterns, any direction vector, or a map from a magnetizing run; a small-magnet model.
Demagnetization	●	The margin to the knee as a field, each magnet's load line and permeance coefficient, irreversible demagnetization solved and reported (share below the knee, lost remanence), the machine short-circuit check.
Temperature dependence	●	Magnets' Br and knee, conductors' resistivity, per study or per body; a temperature map from a heating solve applied element by element.
Conductors	●	Conductivity, isolated or shorted-ends eddy-current modes, a steady velocity through the field (v × B), complex permeability for ferrites.
Electric properties	●	Permittivity, loss tangent, dielectric strength, Paschen data for gases, thermal conductivity, specific heat, density.
Your own library	●	Materials saved to a personal library offered in every project; renaming followed by every body and binding; a material as a design parameter.

Sources and circuits

Coils, windings and what drives them.

Capability		What is supported, and the limit
Coils	●	Any body made a coil: turns, current, direction, stranded or solid, fill factor, strand diameter for proximity loss. 3D: racetrack, solenoid, saddle, diamond and swept coils from their dimensions, with the winding axis found or set.
Coils not meshed	●	3D magnetostatics: round coils driving the model by Biot–Savart without a mesh of their own (large or distant coils).
Circuits	●	Current and voltage sources with DC, sine, exponential, pulse, delayed, damped and table waveforms; series R, L and C; coils in series by circuit name; a three-phase set; peak or RMS entry.
Switches and diodes	●	Voltage sources in transients: a switch by time window, current chopper or rotor position; series, freewheeling and crowbar diodes; capacitor discharge.
Netlists	◐	2D AC and transient: free-form circuits (star, delta, parallel paths, bridges) with sources, R, L, C, diodes, switches by time, current, voltage comparator or rotor angle, and the windings as branches; inverter and SRM half-bridge presets. Not in 3D.
Controller in the loop	●	2D transients: Python code setting the voltage sources before every step from the currents, time and rotor angle (current control, PI loops, PWM).
Current levels	●	Magnetostatics solved once per level with every source scaled (saturation curves, force against current), chosen circuits held fixed.
Applied field	●	A uniform external field on the boundary, with a waveform in time, or a field map from a file.
Terminals	●	Electric studies: bodies at a voltage or floating, grouped by name, with phase in AC current flow.

Motion

Rotors, plungers and armatures.

Capability		What is supported, and the limit
Rotation	◐	2D planar: rotor bodies, a sliding air-gap band, constant speed or an angle table in transients, static position sweeps, AC with the slip from the pole pairs or a motional term. Not in 3D or axisymmetric models.
Speed from the load	●	The equation of motion with inertia, friction, fan and load torque solved with the fields: start-up, run-up, oscillation.
Skew and eccentricity	●	Even skew by slices or a step skew table; static eccentricity with the unbalanced magnetic pull reported.
Stroke	●	Bodies moved along a line and solved at each position (2D and 3D statics; 2D transients in time); a turning mover about a pivot (clapper armatures).
Plunger dynamics	●	A voltage-fed winding driving the mover over the force and inductance tables: mass, spring, friction, loads, stops, gravity, position-controlled switch; closing time and current dip.
Periodic sectors	◐	2D planar: one sector of a rotating machine (even or odd), one period of a linear machine or array. Not in 3D.
Linear and axial machines	◐	Linear machines as a period along x with a stroke; axial-flux machines as 3D statics (no 3D motion yet).

Boundaries, mesh and solver

Getting the right answer, and knowing it.

Capability		What is supported, and the limit
Air region	●	Made and refitted automatically; a padding or margins per axis, bindable to parameters.
Outer boundary	●	Flux tangential or field normal, per face too; an open boundary that maps a shell to infinity for the open-space answer with a small air region.
Symmetry planes	●	Flux tangential or field normal at x, y or z = 0, set by hand or by the symmetry cut; electric symmetry and antisymmetry.
Mesh control	●	Coarse, normal and fine presets; a mesh size per body (bindable); finer mesh on picked faces and edges; curvature and skin-layer settings; a preview before solving.
Adaptive mesh	●	Error-driven refinement over passes to a tolerance, with a cap on elements; dynamic refinement across a transient.
Elements and solvers	◐	First or second order; direct and iterative linear solvers; Newton tolerance and relaxation; adaptive time steps. No higher orders yet.
Check accuracy	●	Solves again with a finer mesh, higher order, tighter tolerance, smaller time step and larger air region, one at a time, and reports how far every result moved.
Solver convergence	●	The nonlinear iterations' history per step as a chart; unconverged steps flagged in the results.
Parallel and background solving	●	Solves run in the background; sweeps solve several variants at once; a stopped run keeps its steps and resumes; the computer kept awake during a solve.

Results and fields

Seeing and measuring the solution.

Capability		What is supported, and the limit
Field plots	●	B, H, J, E, potentials, magnetization, permeability, permeance coefficient, demagnetization margin, energy density, temperature, peak-over-cycle fields, components radial and tangential about an axis; perceptual color maps, bands, fixed ranges, extremes marked.
3D viewing	●	Cut planes with any normal, several planes, a sphere, isosurfaces, the field on chosen bodies' surfaces and on an air-gap cylinder, opacity, slices; the air gap unrolled flat.
Arrows, flux lines, field lines	●	Vector arrows of any field; 2D flux lines; 3D field lines traced from seeds; the mesh over the field.
Stepping through a solution	●	Time steps, AC phase, positions, and a sweep's problems, played or stepped, with one color range.
Quantities	●	Energy and co-energy, per-body volume, mass, flux, mean and peak fields, losses (copper, eddy, iron, proximity, dielectric), forces and torques about any point and axis (Maxwell stress; Arkkio for rotors; virtual work as a cross-check), flux linkage, inductance, resistance, impedance, phase.
Plots	●	Waveforms against time, angle, position, frequency or sweep values; harmonics with THD; a field along a line, arc, circle, helix, grid or point file at any frame; limit lines, styles, zoom.
Probes	●	Points placed by click or coordinates reading B, H, J or E, following frames and sweep variants, saved with the project.
Custom quantities and fields	●	Numbers from expressions of the fields over bodies or paths, kept per solve, swept and optimized; fields of your own from the field calculator; integrals and means over bodies; a deviation map from a reference; the difference from another solution.
Machine-specific results	●	Torque ripple and averages, air-gap force waves by space and time order (noise), multipoles on a reference circle, the inductance matrix, torque and flux linkage split by frozen permeability, nodal forces for structural tools.
Display units	●	Tables and labels in the units you choose (tesla or gauss, N or lbf, mm or in, …), kept with the project; data stay in SI.

Machines and templates

Whole machines from their dimensions.

Capability		What is supported, and the limit
Permanent-magnet machines	●	Surface, inset, buried, spoke, synchronous-reluctance and wound-field rotors from the main dimensions; generated or custom windings (layers, pitch, slot table, hairpin bars, 3-, 5-, 7-phase and dual three-phase); cogging torque, back-EMF, torque against load angle, generator on a load, three-phase short circuit, saturation maps, wound-field curves; the fitted d-q model's torque-speed curve, efficiency map, phasor diagram and generator curves; a 3D model with end windings.
Induction machines	●	Cage or wound rotor; torque and current against speed with the fitted equivalent circuit, no-load and locked-rotor tests, standstill frequency response, starting (direct on line, star-delta, soft start), ratings, doubly fed, self-excited generator, broken bars, inverter supply.
Switched reluctance machines	●	Static map with adaptive angles; the asymmetric half-bridge drive with firing angles and chopping; torque-speed, generating, efficiency map, ratings, stepping-motor use; a drive in time with the field.
Brushed DC machines	●	Magnet or wound poles, slotted armature and commutator; no-load and load solves over a commutation interval, performance against speed on a supply or chopper, commutation in time.
Transformers and inductors	●	Analytic design sheet (flux density, magnetizing current, losses, AC resistance, leakage, regulation; an inductor's L against DC); the field model's open- and short-circuit tests, short-circuit forces, frequency sweep, inductance against current, inrush.
Actuators	●	Plunger solenoid, voice coil, moving-magnet actuator, clapper relay from their dimensions, with an analytic sheet, coil sizing and the force-stroke and dynamics study ready.
Quick design and sizing	●	Analytic estimates in a fraction of a millisecond for PM, induction, SRM, DC and actuator templates, fitted to the field solutions; sizing from a torque; IEC and US efficiency classes.
Thermal network	◐	Lumped network with TEFC, TENV and water-jacket cooling, ducts, duty cycles, steady state and in time, settled with field solutions; a network of your own for any device; ratings under temperature limits (S1 to S10). Not yet calibrated against heat runs (a fit to one is provided).
Drives	●	The inverter switch by switch on the d-q model: space-vector, sine and six-step PWM, hysteresis and block commutation, dead time, device losses; PWM harmonics and their force waves; control tables exported.
Mechanical	●	Rotor stress and the safe speed (core, bridges, sleeve, glue, shaft fit); masses, inertias, a bill of materials with mass and cost; a noise estimate from the force waves.
Drive cycles	●	A vehicle's speed cycle (NEDC, US EPA schedules, or a file) on the efficiency map: energy, losses and temperatures.

Parameters and optimization

Designs, not just models.

Capability		What is supported, and the limit
Design parameters	●	Named values with expressions (arithmetic, functions, if, units, quoted material names, lists); bound to sizes, positions, materials, magnetization angles, mesh sizes, currents, turns, frequency, speed, the air region and the templates' dimensions.
Problem sets	●	List parameters make a set of problems solved in one run, paired or combined, stepped through in the view.
Named designs	●	Sets of values kept under a name, compared, switched, marked read-only; mass and cost estimates per design.
Design sweeps	●	Every combination (or pairing) of parameter values solved, several at a time, resumable; a results window with tables and charts; the variants in the view and as a video.
Optimization	●	On the quick design (thousands of designs a second) or with field solves: Nelder–Mead, differential evolution, CMA-ES, NSGA-II Pareto fronts, Kriging surrogate with expected improvement, gradient descent; objectives, targets and limits; resumable.
Screening and uncertainty	●	Design of experiments (Latin hypercube, factorial), Sobol sensitivity, Monte Carlo over tolerances with the share of designs breaking a limit.
Design explorer	●	Every design solved on the computer, across projects: filters, parallel coordinates, correlations, clusters, and a way back to each design's project. Can be turned off.

Reports and exports

Getting results out.

Capability		What is supported, and the limit
Reports	●	PowerPoint, Word, OpenDocument slides and text, PDF and HTML, with the sections you choose, kept views as figures, your logo and house-style template; also from a script.
Pictures and video	●	PNG or JPEG of the view at any size with a white or transparent background; MP4, GIF or PNG frames of a transient, cycle, stroke or sweep; annotations drawn into the view.
Data	●	Every table and chart as CSV; charts also as PNG, SVG, Excel and MATLAB files; probes and quantities copied to the clipboard.
Fields on the mesh	●	The fields at every node as VTU for a scientific viewer, or as CSV; nodal forces as CSV or a universal file (UNV) for structural and vibration tools.
Circuit models	●	Inductance and resistance matrices as CSV, a SPICE subcircuit of coupled inductors or Touchstone Z-parameters.
System-simulation models	●	Modelica models: an actuator's reduced-order model, a machine's fitted d-q model, an induction machine's circuit, an SRM's static map, a thermal network; control tables for drives.
Geometry	●	STEP of the bodies, DXF of a 2D model's outlines, a magnetization map from a magnetizing run.

Automation

Everything the window does, from Python.

Capability		What is supported, and the limit
Built-in Python	●	A script console in the app, nothing to install; your own packages (numpy, …) installed into a user folder.
The whole model	●	Projects, shapes, sketches, booleans and transforms, imports, materials and B-H data, coils and circuits, netlists, motion, stroke, boundaries, mesh and solver settings, parameters, designs, studies: every model concept has its call.
Solving and results	●	Solve, sweep, design sweeps, problem sets; quantities, forces, torques, probes, fields along paths and on grids, integrals, multipoles, field lines, load lines, plots as data; views, pictures, animations and reports.
Machines from a script	●	Every template and analysis, the quick designs, thermal networks, drives, ratings, rotor stress, drive cycles, optimization, DOE and sensitivity.
Batch and command line	●	Scripts run with or without a window, exit codes and standard output for build servers and agents; projects compared from the command line; a session saved as a script that replays it.
Events and dialogs	●	Handlers before and after every solve and on opening a file; small dialogs asking the user for values; messages.
For AI agents	●	A complete reference of every call as a Markdown file and an automation guide written for agents; mistakes raise Python exceptions and leave the project as it was.

Platforms, files and licensing

Where it runs and how it is kept.

Capability		What is supported, and the limit
Operating systems	◐	Windows (installer) and macOS (Apple silicon, disk image). Linux builds from source; no installer yet.
Project files	●	One `.tlz` file holding the model, materials, settings, attachments and, if you choose, the solution; a small copy without solutions for sharing.
Never losing work	●	Automatic recovery after a crash or a forced restart, a copy of the project with its solution after every solve (never over your file), the versions each save replaced, a change history in words, comparison of two files, meshes and solves that cannot hang the window (Stop always works, a run past its memory limit is stopped), crash reports and a support package with the logs.
Interface	◐	Simple and full layouts, light and dark themes, dockable panels, tooltips on the controls; prepared for other languages (English today).
Licensing	●	Flexible licensing: a personal license file covers two of your computers; team licenses float between people and sign in on any computer, and you take your license back from a computer you left on with one click; features by level; a viewer mode without a license for opening and reading projects; no region locking.
Documentation	●	Tutorials describing every field of every dialog, short feature trainings, worked examples in the app, the Python reference, and the validation report.

Not yet

What TerreLenz doesn’t do.

The honest list, so the answer to “does it do this?” is never a surprise.

Motion in 3D. Rotation, periodic sectors, netlists and the controller in the loop are 2D. 3D transients take current and voltage sources without switches.
3D AC is linear, and 2D AC treats saturation by an effective curve: use a transient for waveforms distorted by saturation.
Element order is 1 or 2.
Hysteresis: minor loops and DC-biased iron loss are not modeled; losses are Bertotti per harmonic.
Structural and acoustic solves: the forces, force waves and a noise estimate are provided for export to structural tools; TerreLenz does not solve vibration or sound itself.
Superconductors, topology optimization and a remote solving service are out of scope for 1.0.
Linux installer: builds from source today.

Does it do this? Every feature, and its limits, on one page.