Surfaces

Components for reading, creating, and analysing Civil 3D TIN surfaces, volume surfaces, and their boundaries, breaklines, contours, and earthwork volumes.


CVL-BoundedVolSurfaces

Civil3d Bounded Volume

Civil3d Bounded Volume icon

Civil3d › Surfaces · Introduced v1.1.19

Calculates cut and fill volumes inside a custom polygon boundary on a Civil 3D volume surface. Draw a closed polygon over the region you care about and feed it in to measure earthwork only within that footprint, rather than across the whole surface. An optional elevation datum lets you measure volumes relative to a chosen reference level. The net volume is reported as cut minus fill.

Inputs

The volume surface to analyze.

BoundaryCurve

Closed polygon defining the region for volume calculation.

DatumNumberoptional

Elevation datum for volume calculation (default 0.0).

Outputs

Cut VolumeNumber

Cut volume within the bounded region.

Fill VolumeNumber

Fill volume within the bounded region.

Net VolumeNumber

Net volume within the bounded region (cut - fill).

Exceptions

LevelMessageCause & fix
WarningNo volume surface providedNo volume surface was supplied. Connect a volume surface to the Volume Surface input.
WarningNo boundary curve providedNo boundary curve was supplied. Connect a closed polygon to the Boundary input.
ErrorBoundary curve must be closedThe supplied boundary is open. Provide a closed curve that fully encloses the region.
ErrorNo document availableThe drawing containing the surface could not be found. Make sure the source drawing is open.
ErrorBoundary must have at least 3 pointsThe boundary did not produce enough points to form a region. Supply a polygon with at least three corners.
ErrorFailed to read Volume SurfaceThe referenced volume surface could not be read. Confirm it still exists in the drawing.
ErrorCivil 3D error: {message}Civil 3D reported an error while calculating the volumes. Check the boundary and surface and try again.
ErrorError calculating bounded volumes: {message}The volume calculation failed unexpectedly. Verify the boundary lies over the surface.

See also

Civil3d TIN Volume Surface, Create Civil3d TIN Volume Surface, Civil3d Volume Properties



CVL-BoundarySurfaces

Civil3d Surface Boundary

Civil3d Surface Boundary icon

Civil3d › Surfaces · Introduced v1.1.19

Breaks a Civil 3D surface boundary down into its individual properties. Use it after pulling boundaries from a TIN surface to read each boundary's role, outline, and name. The type tells you whether the boundary is an outer limit, data clip, hide, or show region.

Inputs

A surface boundary to deconstruct

Outputs

TypeText

Boundary type (Outer, DataClip, Hide, or Show)

PolylineCurve

The boundary polyline geometry

NameText

The boundary name

Exceptions

LevelMessageCause & fix
WarningNo boundary providedNo boundary was supplied. Connect a surface boundary to the input.

See also

Civil3d TIN Surface, Civil3d Surface Contour, Civil3d Surface Breakline



CVL-BreaklineSurfaces

Civil3d Surface Breakline

Civil3d Surface Breakline icon

Civil3d › Surfaces · Introduced v1.1.19

Breaks a Civil 3D surface breakline down into its individual properties. Use it after extracting breaklines from a TIN surface to read each breakline's type, its curve, and its name. The type indicates whether the breakline is standard, a wall, or non-destructive.

Inputs

A surface breakline to deconstruct

Outputs

TypeText

Breakline type (Standard, Wall, or NonDestructive)

CurveCurve

The breakline curve geometry

NameText

The name of the breakline

Exceptions

LevelMessageCause & fix
WarningNo breakline providedNo breakline was supplied. Connect a surface breakline to the input.

See also

Civil3d TIN Surface, Civil3d Surface Boundary, Civil3d Surface Contour



CVL-ContourSurfaces

Civil3d Surface Contour

Civil3d Surface Contour icon

Civil3d › Surfaces · Introduced v1.1.19

Breaks a Civil 3D surface contour down into its individual properties. Use it after extracting contours from a TIN surface to read each contour's type, its line, and its elevation. The type tells you whether the contour is a major or minor line.

Inputs

A surface contour to deconstruct

Outputs

TypeText

Contour type (Major or Minor)

CurveCurve

The contour curve geometry

ElevationNumber

The elevation of the contour

Exceptions

LevelMessageCause & fix
WarningNo contour providedNo contour was supplied. Connect a surface contour to the input.

See also

Civil3d TIN Surface, Civil3d Surface Boundary, Civil3d Surface Breakline



CVL-TINPropsSurfaces

Civil3d TIN Properties

Civil3d TIN Properties icon

Civil3d › Surfaces · Introduced v1.1.19

Extracts individual values from a Civil 3D TIN surface's statistics package. Feed it the properties bundle produced by the Civil3d TIN Surface node to read the surface name, its elevation range, the extent of its bounding area in X and Y, and the style applied to it.

Inputs

TIN properties from a Civil3d Surface

Outputs

NameText

The name of the surface.

Minimum ElevationNumber

The minimum elevation of the surface.

Maximum ElevationNumber

The maximum elevation of the surface.

Minimum XNumber

The minimum X coordinate of the surface extent.

Maximum XNumber

The maximum X coordinate of the surface extent.

Minimum YNumber

The minimum Y coordinate of the surface extent.

Maximum YNumber

The maximum Y coordinate of the surface extent.

The style applied to this TIN surface as a NamedId.

See also

Civil3d TIN Surface



CVL-SurfaceSurfaces

Civil3d TIN Surface

Civil3d TIN Surface icon

Civil3d › Surfaces · Introduced v1.1.19

Extracts information from a Civil 3D TIN surface. Connect a surface to read back its identity, its statistics bundle, and its boundaries, contours, and breaklines, along with a Rhino mesh of the surface for use in Grasshopper. Pass the statistics output into the Civil3d TIN Properties node to read individual values such as elevation range.

Inputs

A Civil3d Surface

Outputs

The Id of the Surface.

Surface statistics (use TIN Properties component to extract values).

The boundary definitions of the Surface.

The contour lines of the Surface.

The breakline definitions of the Surface.

MeshMesh

The surface as a Rhino mesh.

Exceptions

LevelMessageCause & fix
ErrorNo document availableThe drawing containing the surface could not be found. Make sure the source drawing is open.
ErrorFailed to read TIN SurfaceThe referenced surface could not be read. Confirm it still exists in the drawing.

See also

Civil3d TIN Properties, Civil3d Surface Boundary, Civil3d Surface Contour, Civil3d Surface Breakline, Create Civil3d TIN Surface



CVL-VolSurfaceSurfaces

Civil3d TIN Volume Surface

Civil3d TIN Volume Surface icon

Civil3d › Surfaces · Introduced v1.1.19

Extracts information from a Civil 3D TIN volume surface, including its volume statistics. Connect a volume surface to read its identity, name, volume statistics bundle, and the two underlying surfaces it compares. Pass the statistics output into the Civil3d Volume Properties node to read individual cut, fill, and net values.

Inputs

A Civil3d Volume Surface

Outputs

The Id of the Volume Surface.

NameText

The name of the Volume Surface.

Volume PropertiesCivil3d Volume Properties

Volume statistics (use Volume Properties component to extract values).

The base TIN surface.

Comparison SurfaceCivil3d TIN Surface

The comparison TIN surface.

Exceptions

LevelMessageCause & fix
ErrorNo document availableThe drawing containing the volume surface could not be found. Make sure the source drawing is open.
ErrorFailed to read Volume SurfaceThe referenced volume surface could not be read. Confirm it still exists in the drawing.

See also

Civil3d Volume Properties, Civil3d TIN Surface, Create Civil3d TIN Volume Surface, Civil3d Bounded Volume



CVL-VolPropsSurfaces

Civil3d Volume Properties

Civil3d Volume Properties icon

Civil3d › Surfaces · Introduced v1.1.19

Extracts individual values from a Civil 3D volume surface's statistics package. Feed it the properties bundle produced by the Civil3d TIN Volume Surface node to read raw (unadjusted) cut, fill, and net volumes, the cut and fill adjustment factors, the adjusted volumes, and the applied style.

Inputs

Volume PropertiesCivil3d Volume Properties

Volume properties from a Civil3d Volume Surface

Outputs

Unadjusted CutNumber

Raw cut volume before factors (cubic units).

Unadjusted FillNumber

Raw fill volume before factors (cubic units).

Unadjusted NetNumber

Raw net volume (unadjusted cut - unadjusted fill).

Cut FactorNumber

Cut volume adjustment factor.

Fill FactorNumber

Fill volume adjustment factor.

Adjusted CutNumber

Adjusted cut volume (raw * factor).

Adjusted FillNumber

Adjusted fill volume (raw * factor).

Adjusted NetNumber

Adjusted net volume.

The style applied to this volume surface as a NamedId.

See also

Civil3d TIN Volume Surface



CVL-CreateSrfSurfaces

Create Civil3d TIN Surface

Create Civil3d TIN Surface icon

Civil3d › Surfaces · Introduced v1.1.19

Creates a Civil 3D TIN surface from a Rhino mesh. Feed in a mesh and the node builds a surface in the drawing, optionally naming it and applying a surface style; if no name is given, a unique one is generated automatically. It returns the new surface, its name, and its drawing identifier so you can pass them on to other nodes.

Inputs

DocumentAutoCAD Documentoptional

An AutoCAD Document. If not provided, the active document will be used.

MeshMesh

The Rhino Mesh to convert to a TIN Surface.

NameTextoptional

The name for the TIN Surface. If not provided, a unique name will be auto-generated (e.g., GH_TINSurface_001).

StyleCivil3d Surface Styleoptional

The surface style to apply. Can be a style name (string) or a style object. Uses Civil 3D default if not provided.

Outputs

The created TIN Surface.

NameText

The name of the created surface (useful when auto-generated).

The ObjectId of the created surface.

Menu & behaviour

  • Right-click Replace Previous Object (on by default) — deletes the objects this node previously created before making new ones, so editing inputs updates the drawing in place instead of leaving duplicates behind.
  • Right-click Save Connection Between Sessions (on by default) — remembers the link to created objects when the Grasshopper file is saved and reopened.
  • Right-click Clear Connection — forgets the tracked objects without deleting them from the drawing.
  • Skips re-creating objects when inputs are unchanged (shows the remark "No change in inputs, reusing last created"), and defers one solve after a Rhino undo/redo to avoid a Civil 3D crash.

Exceptions

LevelMessageCause & fix
ErrorNo active AutoCAD document availableNo drawing is open or could be resolved. Open a drawing or connect a Document.
WarningNo mesh providedNo mesh was supplied. Connect a mesh to the Mesh input.
ErrorMesh must have at least 3 verticesThe supplied mesh is too small to form a surface. Provide a mesh with at least three vertices.
ErrorFailed to create TIN Surface. The surface name may already exist.The surface could not be created, often because the chosen name is already in use. Use a different name or leave it blank to auto-generate one.
ErrorCivil 3D error: {message}Civil 3D reported an error while building the surface. Check the mesh and style and try again.
ErrorFailed to create TIN Surface: {message}The surface creation failed unexpectedly. Verify the mesh is valid.
ErrorFailed to create TIN SurfaceThe surface could not be created. Check the inputs and try again.

See also

Civil3d TIN Surface, Create Civil3d TIN Volume Surface



CVL-CreateVolSrfSurfaces

Create Civil3d TIN Volume Surface

Create Civil3d TIN Volume Surface icon

Civil3d › Surfaces · Introduced v1.1.19

Creates a Civil 3D TIN volume surface by comparing a base surface against a comparison surface, then reports the resulting earthwork volumes. Use it to measure cut and fill between two states of terrain, such as existing versus proposed ground. It returns the new volume surface, its name and drawing identifier, and the cut, fill, and net volumes.

Inputs

DocumentAutoCAD Documentoptional

An AutoCAD Document. If not provided, the active document will be used.

The base TIN surface for volume calculation.

Comparison SurfaceCivil3d TIN Surface

The comparison TIN surface for volume calculation.

NameTextoptional

The name for the Volume Surface. If not provided, a unique name will be auto-generated.

StyleCivil3d Surface Styleoptional

The surface style to apply. Uses Civil 3D default if not provided.

Outputs

The created Volume Surface.

NameText

The name of the created surface (useful when auto-generated).

The ObjectId of the created surface.

Cut VolumeNumber

Calculated cut volume.

Fill VolumeNumber

Calculated fill volume.

Net VolumeNumber

Calculated net volume.

Menu & behaviour

  • Right-click Replace Previous Object (on by default) — deletes the objects this node previously created before making new ones, so editing inputs updates the drawing in place instead of leaving duplicates behind.
  • Right-click Save Connection Between Sessions (on by default) — remembers the link to created objects when the Grasshopper file is saved and reopened.
  • Right-click Clear Connection — forgets the tracked objects without deleting them from the drawing.
  • Skips re-creating objects when inputs are unchanged (shows the remark "No change in inputs, reusing last created"), and defers one solve after a Rhino undo/redo to avoid a Civil 3D crash.

Exceptions

LevelMessageCause & fix
ErrorNo active AutoCAD document availableNo drawing is open or could be resolved. Open a drawing or connect a Document.
WarningNo base surface providedNo base surface was supplied. Connect a TIN surface to the Base Surface input.
WarningNo comparison surface providedNo comparison surface was supplied. Connect a TIN surface to the Comparison Surface input.
ErrorFailed to create TIN Volume Surface. Check that the base and comparison surfaces are valid.The volume surface could not be created. Confirm both source surfaces are valid and overlap.
ErrorCivil 3D error: {message}Civil 3D reported an error while building the volume surface. Check the source surfaces and style.
ErrorFailed to create TIN Volume Surface: {message}The volume surface creation failed unexpectedly. Verify the inputs.
ErrorFailed to create TIN Volume SurfaceThe volume surface could not be created. Check the inputs and try again.

See also

Civil3d TIN Volume Surface, Create Civil3d TIN Surface, Civil3d Volume Properties, Civil3d Bounded Volume