GET THE ENCLOSED AREA FROM COORDINATES¶
Computes the enclosed (signed or absolute) area of a closed or self-intersecting 2-D curve defined by XY coordinate pairs. Use this worker whenever you need a scalar area metric from a curve — e.g. force-displacement hysteresis energy, stress-strain loop area, or any polygon enclosed by a data series.
When to use¶
Classification: process.
Tagged: curve_integral, enclosed_area, hysteresis, polygon_area, scalar_output, shoelace, xy_coordinates.
Inputs¶
| Label | ID | Type | Default | Required | Description |
|---|---|---|---|---|---|
| Curve Representing Coordinates | curverepresentingcoordinates | vector | — | XY coordinate curve whose enclosed area is to be computed (e.g. a force-displacement loop, stress-strain cycle, or any closed polygon); supply as a two-column vector curve — X values in the first channel and Y values in the second. Optional: if omitted the worker returns no result. |
Outputs¶
| Label | ID | Type | Description |
|---|---|---|---|
| curve_get_enclosed_area_output_1 | curve_get_enclosed_area_output_1 | scalar | Scalar value representing the enclosed area of the input curve, in the natural units of X × Y (e.g. N·mm if the curve is force vs. displacement); computed via the shoelace / trapezoidal-integration method over the coordinate pairs. |
Disciplines¶
- data.curve.transform
- data.statistics
- engineering.material.characterization
Runnable example¶
A runnable example is registered for this worker. Open the example workflow on the d3VIEW canvas: /api/workflow/example?id=curve_get_enclosed_area
Auto-generated from transformation schema. Worker id: curve_get_enclosed_area. Schema hash: 7bec2a9eebf1. Hand-curated docs in workerexamples/ override this page when present.