Surfaces
Components for reading, creating, and analysing Civil 3D TIN surfaces, volume surfaces, and their boundaries, breaklines, contours, and earthwork volumes.
Civil3d Bounded Volume
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
Volume SurfaceCivil3d TIN Volume SurfaceThe volume surface to analyze.
BoundaryCurveClosed polygon defining the region for volume calculation.
DatumNumberoptionalElevation datum for volume calculation (default 0.0).
Outputs
Cut VolumeNumberCut volume within the bounded region.
Fill VolumeNumberFill volume within the bounded region.
Net VolumeNumberNet volume within the bounded region (cut - fill).
Exceptions
| Level | Message | Cause & fix |
|---|---|---|
| Warning | No volume surface provided | No volume surface was supplied. Connect a volume surface to the Volume Surface input. |
| Warning | No boundary curve provided | No boundary curve was supplied. Connect a closed polygon to the Boundary input. |
| Error | Boundary curve must be closed | The supplied boundary is open. Provide a closed curve that fully encloses the region. |
| Error | No document available | The drawing containing the surface could not be found. Make sure the source drawing is open. |
| Error | Boundary must have at least 3 points | The boundary did not produce enough points to form a region. Supply a polygon with at least three corners. |
| Error | Failed to read Volume Surface | The referenced volume surface could not be read. Confirm it still exists in the drawing. |
| Error | Civil 3D error: {message} | Civil 3D reported an error while calculating the volumes. Check the boundary and surface and try again. |
| Error | Error 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
Civil3d Surface Boundary
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
BoundaryCivil3d Surface BoundaryA surface boundary to deconstruct
Outputs
TypeTextBoundary type (Outer, DataClip, Hide, or Show)
PolylineCurveThe boundary polyline geometry
NameTextThe boundary name
Exceptions
| Level | Message | Cause & fix |
|---|---|---|
| Warning | No boundary provided | No boundary was supplied. Connect a surface boundary to the input. |
See also
Civil3d TIN Surface, Civil3d Surface Contour, Civil3d Surface Breakline
Civil3d Surface Breakline
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
BreaklineCivil3d Surface BreaklineA surface breakline to deconstruct
Outputs
TypeTextBreakline type (Standard, Wall, or NonDestructive)
CurveCurveThe breakline curve geometry
NameTextThe name of the breakline
Exceptions
| Level | Message | Cause & fix |
|---|---|---|
| Warning | No breakline provided | No breakline was supplied. Connect a surface breakline to the input. |
See also
Civil3d TIN Surface, Civil3d Surface Boundary, Civil3d Surface Contour
Civil3d Surface Contour
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
ContourCivil3d Surface ContourA surface contour to deconstruct
Outputs
TypeTextContour type (Major or Minor)
CurveCurveThe contour curve geometry
ElevationNumberThe elevation of the contour
Exceptions
| Level | Message | Cause & fix |
|---|---|---|
| Warning | No contour provided | No contour was supplied. Connect a surface contour to the input. |
See also
Civil3d TIN Surface, Civil3d Surface Boundary, Civil3d Surface Breakline
Civil3d TIN Properties
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 PropertiesCivil3d TIN PropertiesTIN properties from a Civil3d Surface
Outputs
NameTextThe name of the surface.
Minimum ElevationNumberThe minimum elevation of the surface.
Maximum ElevationNumberThe maximum elevation of the surface.
Minimum XNumberThe minimum X coordinate of the surface extent.
Maximum XNumberThe maximum X coordinate of the surface extent.
Minimum YNumberThe minimum Y coordinate of the surface extent.
Maximum YNumberThe maximum Y coordinate of the surface extent.
StyleNamed IdThe style applied to this TIN surface as a NamedId.
See also
Civil3d TIN Surface
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
SurfaceCivil3d TIN SurfaceA Civil3d Surface
Outputs
The Id of the Surface.
TIN PropertiesCivil3d TIN PropertiesSurface statistics (use TIN Properties component to extract values).
BoundariesCivil3d Surface BoundaryThe boundary definitions of the Surface.
ContoursCivil3d Surface ContourThe contour lines of the Surface.
BreaklinesCivil3d Surface BreaklineThe breakline definitions of the Surface.
MeshMeshThe surface as a Rhino mesh.
Exceptions
| Level | Message | Cause & fix |
|---|---|---|
| Error | No document available | The drawing containing the surface could not be found. Make sure the source drawing is open. |
| Error | Failed to read TIN Surface | The 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
Civil3d TIN Volume Surface
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
Volume SurfaceCivil3d TIN Volume SurfaceA Civil3d Volume Surface
Outputs
The Id of the Volume Surface.
NameTextThe name of the Volume Surface.
Volume PropertiesCivil3d Volume PropertiesVolume statistics (use Volume Properties component to extract values).
Base SurfaceCivil3d TIN SurfaceThe base TIN surface.
Comparison SurfaceCivil3d TIN SurfaceThe comparison TIN surface.
Exceptions
| Level | Message | Cause & fix |
|---|---|---|
| Error | No document available | The drawing containing the volume surface could not be found. Make sure the source drawing is open. |
| Error | Failed to read Volume Surface | The 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
Civil3d Volume Properties
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 PropertiesVolume properties from a Civil3d Volume Surface
Outputs
Unadjusted CutNumberRaw cut volume before factors (cubic units).
Unadjusted FillNumberRaw fill volume before factors (cubic units).
Unadjusted NetNumberRaw net volume (unadjusted cut - unadjusted fill).
Cut FactorNumberCut volume adjustment factor.
Fill FactorNumberFill volume adjustment factor.
Adjusted CutNumberAdjusted cut volume (raw * factor).
Adjusted FillNumberAdjusted fill volume (raw * factor).
Adjusted NetNumberAdjusted net volume.
StyleNamed IdThe style applied to this volume surface as a NamedId.
See also
Create Civil3d TIN Surface
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
An AutoCAD Document. If not provided, the active document will be used.
MeshMeshThe Rhino Mesh to convert to a TIN Surface.
NameTextoptionalThe name for the TIN Surface. If not provided, a unique name will be auto-generated (e.g., GH_TINSurface_001).
StyleCivil3d Surface StyleoptionalThe surface style to apply. Can be a style name (string) or a style object. Uses Civil 3D default if not provided.
Outputs
SurfaceCivil3d TIN SurfaceThe created TIN Surface.
NameTextThe 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
| Level | Message | Cause & fix |
|---|---|---|
| Error | No active AutoCAD document available | No drawing is open or could be resolved. Open a drawing or connect a Document. |
| Warning | No mesh provided | No mesh was supplied. Connect a mesh to the Mesh input. |
| Error | Mesh must have at least 3 vertices | The supplied mesh is too small to form a surface. Provide a mesh with at least three vertices. |
| Error | Failed 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. |
| Error | Civil 3D error: {message} | Civil 3D reported an error while building the surface. Check the mesh and style and try again. |
| Error | Failed to create TIN Surface: {message} | The surface creation failed unexpectedly. Verify the mesh is valid. |
| Error | Failed to create TIN Surface | The surface could not be created. Check the inputs and try again. |
See also
Civil3d TIN Surface, Create Civil3d TIN Volume Surface
Create Civil3d TIN Volume Surface
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
An AutoCAD Document. If not provided, the active document will be used.
Base SurfaceCivil3d TIN SurfaceThe base TIN surface for volume calculation.
Comparison SurfaceCivil3d TIN SurfaceThe comparison TIN surface for volume calculation.
NameTextoptionalThe name for the Volume Surface. If not provided, a unique name will be auto-generated.
StyleCivil3d Surface StyleoptionalThe surface style to apply. Uses Civil 3D default if not provided.
Outputs
Volume SurfaceCivil3d TIN Volume SurfaceThe created Volume Surface.
NameTextThe name of the created surface (useful when auto-generated).
The ObjectId of the created surface.
Cut VolumeNumberCalculated cut volume.
Fill VolumeNumberCalculated fill volume.
Net VolumeNumberCalculated 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
| Level | Message | Cause & fix |
|---|---|---|
| Error | No active AutoCAD document available | No drawing is open or could be resolved. Open a drawing or connect a Document. |
| Warning | No base surface provided | No base surface was supplied. Connect a TIN surface to the Base Surface input. |
| Warning | No comparison surface provided | No comparison surface was supplied. Connect a TIN surface to the Comparison Surface input. |
| Error | Failed 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. |
| Error | Civil 3D error: {message} | Civil 3D reported an error while building the volume surface. Check the source surfaces and style. |
| Error | Failed to create TIN Volume Surface: {message} | The volume surface creation failed unexpectedly. Verify the inputs. |
| Error | Failed to create TIN Volume Surface | The 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