Python

Digi3D.AI supports Python programming in three ways, depending on where and how the code runs, each intended for a different purpose:

Approach Description Uses digi3d?
Console applications Regular Python programs outside Digi3D.AI that read, process and create drawing files. No
Python pane Scripts running inside Digi3D.AI on the active drawing. Yes
Quality controls Functions validating a code's geometries. Yes

Target Python version: 3.12 (x64). The entire API is in English: classes use PascalCase; methods, properties and arguments use snake_case. Coordinates are (x, y, z) tuples.

Console applications

Python programs running in a system interpreter outside Digi3D.AI, using digi21.base and digi21.io to read, process and create drawing files (convert formats, extract information, generate reports…). They do not use digi3d.

Python pane

Runs scripts inside Digi3D.AI, accessing the active drawing through digi3d. Run them from the Python script pane or as a command by name.

Quality controls

Functions that validate a code's geometries, in real time while digitizing or on demand. They also use digi3d.

Digi21 script repositories

Digi21 publishes two GitHub script repositories for Digi3D.AI:

Reference

The API reference formally describes three modules: digi21.base (core types), digi21.io (file reading and writing) and digi3d (available inside the program).

For coordinate transformations between reference systems from Python programs, use crskit, Digi3D.AI's reference system library. It is not distributed with Digi3D.AI: install it with pip install crskit.