digi21.io
Read and write Digi3D.AI drawing files from Python using the application importers and exporters. Each format has a separate module, sharing an interface: open returns an iterable DrawingFile, and create returns a DrawingWriter.
Uses digi21.base types for geometries read and written.
Format modules
| Module | Format | Extension | Reads | Writes | crs in create |
Page |
|---|---|---|---|---|---|---|
digi21.io.bin |
BIN | .bin |
Yes | Yes | Required | bin |
digi21.io.bindouble |
Double-precision BIN | .bind |
Yes | Yes | Required | bindouble |
digi21.io.asciidigi |
Digi ASCII | .asc |
Yes | Yes | Required | asciidigi |
digi21.io.dgn |
MicroStation DGN V8 | .dgn |
Yes | Yes | Required | dgn |
digi21.io.dwg |
AutoCAD DWG | .dwg |
Yes | Yes | Required | dwg |
digi21.io.dxf |
AutoCAD DXF | .dxf |
Yes | Yes | Required | dxf |
digi21.io.geojson |
GeoJSON | .geojson |
Yes | Yes | Optional | geojson |
digi21.io.kml |
KML | .kml |
Yes | Yes | Optional | kml |
digi21.io.svg |
SVG | .svg |
Yes | Yes | Optional | svg |
digi21.io.wkt |
WKT geometries | .wkt |
Yes | Yes | Optional | wkt |
digi21.io.geopackage |
OGC GeoPackage | .gpkg |
Yes | Yes | Required | geopackage |
digi21.io.shp |
ESRI Shapefile | .shp |
Yes | Yes | Required | shp |
digi21.io.pdf |
.pdf |
No | Yes | Optional | ||
digi21.io.geomedia |
GeoMedia Access warehouse | .mdb |
Yes | Append to existing warehouse | Optional | geomedia |
digi21.io.postgis |
PostGIS database | .pg (connection file) |
Yes | Append to existing tables | Optional | postgis |
digi21.io.ifc |
IFC | .ifc |
Yes | Building faces only | Optional | ifc |
digi21.io.vec |
VEC | .vec |
Yes | Yes | Optional | vec |
Each page provides open and create signatures, format parameters, exporter rejections, code table requirements, and executed examples with output.
Esri File Geodatabase (.gdb) has no module. Its engine takes a dataset (feature class collection) parameter. Without it, the application opens dataset selection; a console application uses the sole dataset or, if several exist, raises an error requesting the parameter.
open
open(path, digitab=None) -> DrawingFile
| Argument | Type | Description |
|---|---|---|
path |
str |
File path to read |
digitab |
DigiTab | Optional code table; defaults to empty |
Returns a DrawingFile. Iteration is lazy, reading geometries as needed. DrawingFile.crs is the file coordinate system or an empty string.
Nonexistent path raises FileNotFoundError. digi21.io.pdf has no open. digi21.io.bin adds precision and global_origin to open because BIN does not store them in the file.
create
create(path, digitab=None, crs="", *, <parámetros del formato>) -> DrawingWriter
| Argument | Type | Description |
|---|---|---|
path |
str |
Output path. Replaces an existing file |
digitab |
DigiTab | Optional code table providing layer, level, color, etc. for each code. Defaults to empty |
crs |
str |
File coordinate system as WKT or "EPSG:<código>". Required by formats storing it (see table); missing values make create raise ValueError. Pass another file DrawingFile.crs to preserve its system |
Format parameters are keyword-only, with the exporter defaults. These are the parameters accepted by IMPORTATION_PARAMETERS for that format, documented on each module page.
Common exceptions:
| Exception | When |
|---|---|
ValueError |
Missing required crs, crs containing invalid WKT or EPSG code, or an out-of-range format parameter |
FileNotFoundError |
Parent folder of path does not exist |
RuntimeError |
Exporter reports an error, including its message |
Shared behavior
Writer and context manager
create returns a DrawingWriter. Files are incomplete until the writer closes: use with for automatic closure on exit, or call close().
with modulo.create("destino.ext", digitab, crs="EPSG:25830") as writer:
writer.add(geometry)
print(writer.written, writer.rejected)
add(geometry)returnsFalseif unwritten;rejectedcounts unwritten geometries.writtencounts output entities. Formats without multiple codes per entity write a geometry with n codes n times.warningslists exporter messages: untranslated codes, created layers, rejected geometries, etc. Native exporter warnings use the installation language; Python module warnings use English.
Coordinate system
Exporters do not transform coordinates: they write supplied values. crs identifies their system. Pass source crs when converting:
origen = bind.open("parcelas.bind")
with dxf.create("parcelas.dxf", crs=origen.crs) as writer:
for geometry in origen:
writer.add(geometry)
GeoJSON and KML expect longitude and latitude in degrees; source coordinates must already use that system.
Formats storing systems in .prj (BIN, Digi ASCII, DGN, DWG, DXF, SHP) preserve an existing same-name destination .prj instead of writing the crs supplied to create. warnings reports the preserved .prj. Delete that .prj before creation to use crs.
Code table and import order
Load code tables with DigiTab.load after importing every format module needed. The first table loaded in the process receives translation parameters (iodgn:transform, ioshp:transform, iogpkg:transform, etc.) only from modules already imported.
import digi21.io.dgn as dgn
import digi21.io.shp as shp
from digi21.base import DigiTab
digitab = DigiTab.load("Digi.tab.xml")
SVG, GeoPackage, SHP, GeoMedia, and PostGIS reject geometries whose code lacks its table translation element. DGN, DWG, and DXF write them with defaults in a layer or level named after the code.
Example data
Module page examples use:
Digi.tab.xml: three codes,010123(points),040645(lines), and020402(polygons), with format translations. Each page shows the required fragment.parcelas.bind: created by the first digi21.io.bindouble example, containing a point, line, polygon, and text in ETRS89 / UTM 30N (EPSG:25830). Source for conversion examples.