2D Planar Field Map, Layers & Section Tools¶
Last changes: Documentation changelog
FieldMapModule (apps/control-room/src/modules/field-map/FieldMapModule.tsx) provides the
Control Room’s 2D planar probe, cross-section renderer, multi-layer overlay compositor, and
hysteresis snapshot browser. Sections can render either an authored PlanarMonitor or interactive
XY / XZ / YZ cut planes synchronized with visualization state.
Section Planes, Interactive Tools & Exports (PlanarToolbar)¶
The top PlanarToolbar (apps/control-room/src/modules/field-map/components/PlanarToolbar.tsx)
exposes roving-focus toolbar controls grouped into section orientation, cursor mode, navigation,
overlay masks, and export:
Toolbar group |
Exact controls |
Behavior |
|---|---|---|
Section plane |
|
Selects the active orthogonal slice plane ( |
Tools ( |
|
Controls pointer interaction on the planar canvas |
Navigation |
|
Zooms or resets camera framing |
Layer masks |
|
Toggles overlaid vector glyphs, sample markers, cross-section mesh wireframe, magnetic/flux streamlines, scalar contours, multislice panel mode, and |
Exports |
|
Saves the visible 2D canvas capture or CSV slice values ( |
Field Lines & Contours: Toggling Field lines and Contours renders iso-value contour lines and tangential vector streamlines derived from the sampled 2D slice (
planarFieldComposition.ts).Line Profile & Measure: Using Line profile draws a draggable cut chord across the slice and opens
PlanarProfileChartalongside exact spatial distances via Measure.Hover & Click Probe:
PlanarNodeInspector(PlanarNodeReadout.tsx) reports exact physical \((x, y, z)\) coordinates, active quantity value, display unit conversion, and component vector readout.
Multi-Slice Panels, Ordered Layer Stack & Hysteresis Playback¶
Ordered Field Layer Stack (
PlanarFieldLayerList): Underinspector/visualization/PlanarFieldLayerList.tsx, the 2D view supports up toPLANAR_FIELD_LAYERS_MAXstacked target layers (all,airbox,object:<id>), reorderable via drag-and-drop orAlt+ArrowUp/Alt+ArrowDown. Each layer independently configures quantity, derived component (planarComponentDerivation.ts), colormap, vector arrows, and visibility.Multi-Slice Grid (
PlanarMultisliceGrid): Enabling Slice panels tiles multiple axial slice offsets across the thickness or domain axis (MULTISLICE_MIN_PANELStoMULTISLICE_MAX_PANELS) with shared normalized or direction legends (PlanarColorLegend).Hysteresis Snapshot Navigation (
PlanarSnapshotNavigator): When browsing a completed or running hysteresis stage, a toolbar (Snapshot k / N · B = ... mT, Previous/Next, Play/Pause, Live) steps deterministically through saved field-sweep snapshots, waiting for each frame’sstatus === "ready"before advancing playback.
Screenshots illustrate the interface; they are not runtime or physics qualification evidence.
Control Room crosswalk¶
Primary module:
FieldMapModule(apps/control-room/src/modules/field-map/FieldMapModule.tsx).Inspector companions:
PlanarMonitorDraftInspectorPanel,PlanarMonitorInspectorPanel,PlanarFieldLayerList, andPlanarSectionPlaneSection.Rendering boundary: Planar slices sample backend field resources (
usePlanarScalarResource,usePlanarVectorResource,usePlanarMeshOverlayResource,usePlanarProfileResource) and never compute solver residuals locally.
Python/API crosswalk¶
Planar monitor definitions authored in UI commit to the session planar monitor catalog matching Python monitor definitions.
Line profiles and CSV slice exports represent sampled visualization buffers for interactive analysis; full volumetric outputs remain in session/Zarr artifacts.
Physics and bibliography scope¶
This page covers 2D slice rendering, component projection, contour/streamline generation, and UI probing tools; it introduces no independent physical equations.
Source-code index¶
Responsibility |
Repository path |
Stable symbol |
|---|---|---|
2D planar field map module & data plan |
|
|
Section, tool, navigation & mask toolbar |
|
|
Multi-layer stack & keyboard reordering |
|
|
Multi-slice panel layout |
|
|
Hysteresis snapshot stepper & replay |
|
|
Scalar & HSL direction legends |
|
|
Line-profile chart & CSV export |
|
|