# dtgoitia/civil-autolisp architecture

> Architecture diagram of the GitHub repository dtgoitia/civil-autolisp, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-05). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/dtgoitia/civil-autolisp
- Repository: https://github.com/dtgoitia/civil-autolisp

## Overview

This repository is a personal collection of AutoLISP tools for civil engineering workflows in AutoCAD, rather than a single application with a unified runtime pipeline. README documents loading scripts into AutoCAD and invoking their command names. The tree shows capabilities for levels, roads, drainage, structural work, and shared utilities, but source excerpts cover only a standalone grid-coordinate conversion; links between the broader scripts are therefore omitted.

Main entry points: [`Dump folder/GoogleMaps.js`](https://github.com/dtgoitia/civil-autolisp/blob/master/Dump%20folder/GoogleMaps.js) (Grid conversion), [`CIVIL - Interpolate level.lsp`](https://github.com/dtgoitia/civil-autolisp/blob/master/CIVIL%20-%20Interpolate%20level.lsp) (Level commands), [`CIVIL - Interpolate level 3D.lsp`](https://github.com/dtgoitia/civil-autolisp/blob/master/CIVIL%20-%20Interpolate%20level%203D.lsp) (3D interpolation), [`CIVIL - Road Levels.lsp`](https://github.com/dtgoitia/civil-autolisp/blob/master/CIVIL%20-%20Road%20Levels.lsp) (Road levels)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_levels["Civil levels"]
  node_level_commands["Level commands"]
  node_level_3d["3D interpolation"]
  node_road_levels["Road levels"]
  node_plot_levels["Plot levels"]
  node_setting_out["Setting out"]
  node_house_polylines["House polylines"]
end

subgraph group_drainage["Drainage tools"]
  node_drainage_menu["Drainage menu<br/>[CIVIL Drainage.lsp]"]
  node_manholes["Dynamic manholes"]
  node_single_pipe["Single pipe"]
  node_manhole_schedule["Manhole schedule"]
end

subgraph group_structural["Structural tools"]
  node_coord_table["Coordinate table"]
  node_building_blocks["Building blocks"]
  node_live_offset["Live offset"]
end

subgraph group_shared["Shared AutoLISP"]
  node_core_library["Function library"]
  node_dynamic_interpolation["Dynamic interpolation"]
  node_autoload["Auto-load setup<br/>[_AutoLoad.lsp]"]
end

subgraph group_mapping["Coordinate mapping"]
  node_coordinate_conversion["Grid conversion<br/>[GoogleMaps.js]"]
end

node_engineer(("Civil engineer"))
node_autocad["AutoCAD"]

node_engineer -->|"loads scripts"| node_autocad
node_autocad -->|"runs commands"| node_level_commands
node_autocad -->|"runs commands"| node_level_3d
node_autocad -->|"runs commands"| node_road_levels
node_autocad -->|"runs commands"| node_plot_levels
node_autocad -->|"runs commands"| node_setting_out
node_autocad -->|"runs commands"| node_house_polylines
node_autocad -->|"runs commands"| node_drainage_menu
node_autocad -->|"runs commands"| node_manholes
node_autocad -->|"runs commands"| node_single_pipe
node_autocad -->|"runs commands"| node_manhole_schedule
node_autocad -->|"runs commands"| node_coord_table
node_autocad -->|"runs commands"| node_building_blocks
node_autocad -->|"runs commands"| node_live_offset
node_autocad -->|"loads scripts"| node_core_library
node_autocad -->|"loads scripts"| node_dynamic_interpolation
node_autocad -->|"loads scripts"| node_autoload
node_coordinate_conversion -.->|"converts coordinates"| node_autocad

click node_level_commands "https://github.com/dtgoitia/civil-autolisp/blob/master/CIVIL%20-%20Interpolate%20level.lsp"
click node_level_3d "https://github.com/dtgoitia/civil-autolisp/blob/master/CIVIL%20-%20Interpolate%20level%203D.lsp"
click node_road_levels "https://github.com/dtgoitia/civil-autolisp/blob/master/CIVIL%20-%20Road%20Levels.lsp"
click node_plot_levels "https://github.com/dtgoitia/civil-autolisp/blob/master/CIVIL%20-%20Plot%20Levels.lsp"
click node_setting_out "https://github.com/dtgoitia/civil-autolisp/blob/master/CIVIL%20-%20Setting%20Out.lsp"
click node_house_polylines "https://github.com/dtgoitia/civil-autolisp/blob/master/CIVIL%20-%20House%20polylines.lsp"
click node_drainage_menu "https://github.com/dtgoitia/civil-autolisp/blob/master/CIVIL%20Drainage.lsp"
click node_manholes "https://github.com/dtgoitia/civil-autolisp/blob/master/DRAINAGE%20-%20Dynamic%20manholes.lsp"
click node_single_pipe "https://github.com/dtgoitia/civil-autolisp/blob/master/DRAINAGE%20-%20Draw%20single%20pipe.lsp"
click node_manhole_schedule "https://github.com/dtgoitia/civil-autolisp/blob/master/DRAINAGE%20-%20Create%20manhole%20schedule.lsp"
click node_coord_table "https://github.com/dtgoitia/civil-autolisp/blob/master/STRUCTURAL%20-%20Coordinate%20table.lsp"
click node_building_blocks "https://github.com/dtgoitia/civil-autolisp/blob/master/STRUCTURAL%20-%20Create%20building%20blocks.lsp"
click node_live_offset "https://github.com/dtgoitia/civil-autolisp/blob/master/STRUCTURAL%20-%20Live%20offset.lsp"
click node_core_library "https://github.com/dtgoitia/civil-autolisp/blob/master/0%20-%20Function%20library.lsp"
click node_dynamic_interpolation "https://github.com/dtgoitia/civil-autolisp/blob/master/0%20-%20Dynamic%20Interpolation.lsp"
click node_autoload "https://github.com/dtgoitia/civil-autolisp/blob/master/_AutoLoad.lsp"
click node_coordinate_conversion "https://github.com/dtgoitia/civil-autolisp/blob/master/Dump%20folder/GoogleMaps.js"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_level_commands,node_level_3d,node_road_levels,node_plot_levels,node_setting_out,node_house_polylines toneBlue
class node_drainage_menu,node_manholes,node_single_pipe,node_manhole_schedule toneAmber
class node_coord_table,node_building_blocks,node_live_offset toneMint
class node_core_library,node_dynamic_interpolation,node_autoload toneRose
class node_coordinate_conversion,node_engineer,node_autocad toneIndigo
```

## Components

### Civil levels

- [Level commands](https://github.com/dtgoitia/civil-autolisp/blob/master/CIVIL%20-%20Interpolate%20level.lsp): `CIVIL - Interpolate level.lsp`
- [3D interpolation](https://github.com/dtgoitia/civil-autolisp/blob/master/CIVIL%20-%20Interpolate%20level%203D.lsp): `CIVIL - Interpolate level 3D.lsp`
- [Road levels](https://github.com/dtgoitia/civil-autolisp/blob/master/CIVIL%20-%20Road%20Levels.lsp): `CIVIL - Road Levels.lsp`
- [Plot levels](https://github.com/dtgoitia/civil-autolisp/blob/master/CIVIL%20-%20Plot%20Levels.lsp): `CIVIL - Plot Levels.lsp`
- [Setting out](https://github.com/dtgoitia/civil-autolisp/blob/master/CIVIL%20-%20Setting%20Out.lsp): `CIVIL - Setting Out.lsp`
- [House polylines](https://github.com/dtgoitia/civil-autolisp/blob/master/CIVIL%20-%20House%20polylines.lsp): `CIVIL - House polylines.lsp`

### Drainage tools

- [Drainage menu](https://github.com/dtgoitia/civil-autolisp/blob/master/CIVIL%20Drainage.lsp): `CIVIL Drainage.lsp`
- [Dynamic manholes](https://github.com/dtgoitia/civil-autolisp/blob/master/DRAINAGE%20-%20Dynamic%20manholes.lsp): `DRAINAGE - Dynamic manholes.lsp`
- [Single pipe](https://github.com/dtgoitia/civil-autolisp/blob/master/DRAINAGE%20-%20Draw%20single%20pipe.lsp): `DRAINAGE - Draw single pipe.lsp`
- [Manhole schedule](https://github.com/dtgoitia/civil-autolisp/blob/master/DRAINAGE%20-%20Create%20manhole%20schedule.lsp): `DRAINAGE - Create manhole schedule.lsp`

### Structural tools

- [Coordinate table](https://github.com/dtgoitia/civil-autolisp/blob/master/STRUCTURAL%20-%20Coordinate%20table.lsp): `STRUCTURAL - Coordinate table.lsp`
- [Building blocks](https://github.com/dtgoitia/civil-autolisp/blob/master/STRUCTURAL%20-%20Create%20building%20blocks.lsp): `STRUCTURAL - Create building blocks.lsp`
- [Live offset](https://github.com/dtgoitia/civil-autolisp/blob/master/STRUCTURAL%20-%20Live%20offset.lsp): `STRUCTURAL - Live offset.lsp`

### Shared AutoLISP

- [Function library](https://github.com/dtgoitia/civil-autolisp/blob/master/0%20-%20Function%20library.lsp): `0 - Function library.lsp`
- [Dynamic interpolation](https://github.com/dtgoitia/civil-autolisp/blob/master/0%20-%20Dynamic%20Interpolation.lsp): `0 - Dynamic Interpolation.lsp`
- [Auto-load setup](https://github.com/dtgoitia/civil-autolisp/blob/master/_AutoLoad.lsp): `_AutoLoad.lsp`

### Coordinate mapping

- [Grid conversion](https://github.com/dtgoitia/civil-autolisp/blob/master/Dump%20folder/GoogleMaps.js): `Dump folder/GoogleMaps.js`

### Other components

- **Civil engineer**
- **AutoCAD**

## Connections

- Civil engineer → AutoCAD: loads scripts (evidence: `README.md`)
- AutoCAD → Level commands: runs commands (evidence: `README.md`)
- AutoCAD → 3D interpolation: runs commands (evidence: `README.md`)
- AutoCAD → Road levels: runs commands (evidence: `README.md`)
- AutoCAD → Plot levels: runs commands (evidence: `README.md`)
- AutoCAD → Setting out: runs commands (evidence: `README.md`)
- AutoCAD → House polylines: runs commands (evidence: `README.md`)
- AutoCAD → Drainage menu: runs commands (evidence: `README.md`)
- AutoCAD → Dynamic manholes: runs commands (evidence: `README.md`)
- AutoCAD → Single pipe: runs commands (evidence: `README.md`)
- AutoCAD → Manhole schedule: runs commands (evidence: `README.md`)
- AutoCAD → Coordinate table: runs commands (evidence: `README.md`)
- AutoCAD → Building blocks: runs commands (evidence: `README.md`)
- AutoCAD → Live offset: runs commands (evidence: `README.md`)
- AutoCAD → Function library: loads scripts (evidence: `README.md`)
- AutoCAD → Dynamic interpolation: loads scripts (evidence: `README.md`)
- AutoCAD → Auto-load setup: loads scripts (evidence: `README.md`)
- Grid conversion → AutoCAD: converts coordinates
