🔳

Area

Layout
Run the live example Free · no sign-up · runs in your browser

The Area block provides visual grouping and structural zoning on the simulation canvas. It creates a labeled, resizable rectangular boundary with customizable background coloring, enabling engineers to group related components, partition signal flow paths, and annotate functional subsystems directly on the diagram surface.

Because it serves purely as a visual annotation and layout organization tool, the Area block does not alter signal routing, execution order, or numerical solver dynamics.

Mathematical Model

Ω=[xmin⁡,xmax⁡]×[ymin⁡,ymax⁡]⊂R2\Omega = [x_{\min}, x_{\max}] \times [y_{\min}, y_{\max}] \subset \mathbb{R}^2

Where:

  • Ω\Omega defines the two-dimensional spatial bounding box of the visual grouping area on the canvas.
  • A block BiB_i located at spatial coordinates (xi,yi)(x_i, y_i) belongs to the logical grouping if (xi,yi)∈Ω(x_i, y_i) \in \Omega.
  • The rendering function R(Ω,cbg)\mathcal{R}(\Omega, c_{\text{bg}}) applies background fill color cbgc_{\text{bg}} without altering simulation state vector x(t)\mathbf{x}(t).

Parameters

Parameters Label Type Default Description
backgroundColor Color select transparent
userNotes Label text

Usage Examples

Example 1: Grouping Motor Drive Electronics

An Area block with a light blue background encompasses the PWM generator, inverter switches, and current sense blocks, labeled "Three-Phase Inverter Stage".

Example 2: Highlighting Feedback Control Loops

An Area block colored in light green encloses the PID controller, anti-windup limiter, and lead-lag compensator to clearly distinguish control logic from plant dynamics.

Remarks & Best Practices

  • Canvas organization: Visually demarcates subsystems and complex multi-loop architectures without introducing hierarchical encapsulation.
  • Zero computational cost: Evaluated entirely within the React UI rendering layer; does not consume WASM simulation cycles or solver memory.
  • Dynamic resizing: Dragging the corner handles resizes the boundary to encompass new blocks as diagrams expand.
  • Layout preservation: Moving an Area block moves all blocks contained within its geometric boundary simultaneously.

Related Components

  • TextNote: Adds unbordered floating text annotations and markdown notes to the canvas.
  • Subsystem: Encapsulates blocks into a hierarchical, reusable block with formal InPort and OutPort interfaces.