Interoperability¶

Reading and writing other formats is split in two:

ada.cadit handles CAD/BIM formats: IFC, STEP, SAT, Genie XML/GNX, DEXPI and AVEVA E3D macros, plus NGEOM, the native interchange with adacpp.
ada.fem.formats handles finite element formats: solver input decks, solver execution and results.

Both are reached through the functions in ada/factories.py and the export methods on Part / Assembly.

Entry points¶

flowchart LR subgraph read["ada.factories"] FI["from_ifc(reader=ifcopenshell | native)"] FS["from_step(reader=occ | stream | auto | tolerant | native)<br/>iter_from_step()"] FA["from_acis()"] FG["from_genie_xml() · from_gnx()"] FD["from_dexpi() · dexpi_to_procedural()"] FF["from_fem()"] FR["from_fem_res()"] FC["from_sesam_cc() · from_pickle()"] end subgraph cadit["ada.cadit"] IFC["ifc/"] STEP["step/ (+ ada.occ.step)"] SAT["sat/"] GXML["gxml/"] DEXPI["dexpi/"] E3D["e3d/"] NGEOM["ngeom/"] end subgraph fe["ada.fem.formats"] GEN["general.py<br/>get_fem_imports · get_fem_exports<br/>get_fem_executable · write_to_fem"] POST["postprocess.py"] end FI --> IFC FS --> STEP FA --> SAT FG --> GXML FD --> DEXPI FF --> GEN FR --> POST ASM(["Assembly"]) ASM -- "to_ifc()" --> IFC ASM -- "to_stp()" --> STEP ASM -- "to_genie_xml() · to_gnx()" --> GXML ASM -- "to_aveva_mac()" --> E3D ASM -- "to_fem()" --> GEN IFC & STEP -. "native paths" .-> NGEOM click IFC href "https://github.com/Krande/adapy/tree/main/src/ada/cadit/ifc" "IFC read/write, IfcStore" click STEP href "https://github.com/Krande/adapy/tree/main/src/ada/cadit/step" "STEP read/write and streaming" click SAT href "https://github.com/Krande/adapy/tree/main/src/ada/cadit/sat" "ACIS SAT" click GXML href "https://github.com/Krande/adapy/tree/main/src/ada/cadit/gxml" "Genie XML / GNX" click DEXPI href "https://github.com/Krande/adapy/tree/main/src/ada/cadit/dexpi" "DEXPI P&ID" click E3D href "https://github.com/Krande/adapy/tree/main/src/ada/cadit/e3d" "AVEVA E3D macros" click NGEOM href "https://github.com/Krande/adapy/tree/main/src/ada/cadit/ngeom" "Native geometry interchange" click GEN href "https://github.com/Krande/adapy/blob/main/src/ada/fem/formats/general.py" "FE format dispatch" click POST href "https://github.com/Krande/adapy/blob/main/src/ada/fem/formats/postprocess.py" "Result readers" click FI href "https://github.com/Krande/adapy/blob/main/src/ada/factories.py" "from_ifc" click FS href "https://github.com/Krande/adapy/blob/main/src/ada/factories.py" "from_step" click FF href "https://github.com/Krande/adapy/blob/main/src/ada/factories.py" "from_fem" click FR href "https://github.com/Krande/adapy/blob/main/src/ada/factories.py" "from_fem_res"

CAD / BIM formats¶

Format	Read	Write	Notes
IFC	`cadit/ifc/read/read_ifc.IfcReader` (typed beams, plates, …, via ifcopenshell); `read/native_reader.native_read_ifc_into` (adacpp, `ShapeProxy` objects)	`write/write_ifc.IfcWriter`; `write/stream_ifc.stream_assembly_to_ifc` (memory-bounded); `write/native_ifc_writer.native_write_ifc` (`Assembly.to_ifc(writer="native")`)	`cadit/ifc/store.IfcStore` holds the ifcopenshell file and syncs changes (`sync`, `save_to_file`, `get_ifc_geom_iterator`). `native_ifc_to_glb` skips the object model.
STEP	`ada/occ/step` (pythonocc); `cadit/step/read/adacpp_store.AdacppStepStore`; native readers	`ada/occ/step/writer`; `cadit/step/write/adacpp_writer.AdacppStepWriter`	`cadit/step/store.py` and `write/writer.py` are re-export shims. Streaming: `stream_to_glb`, `glb_spill`, `native_step_to_{glb,ifc,step,mesh}`, `step2glb_capi`.
SAT (ACIS)	`sat/store.SatStore`, `SatReader`	`sat/write/writer.py`	Has its own text parser.
Genie XML / GNX	`gxml/store.GxmlStore`, `gxml/read/*` (including loads)	`gxml/write/write_xml.py`, `write_gnx.py`	The DNV GeniE concept model, with concept loads and constraints.
DEXPI	`dexpi/store.DexpiStore`, `read_dexpi` (Proteus and DEXPI 2.0)	`dexpi` writers	`read/to_procedural.py` turns a P&ID into a procedural model.
AVEVA E3D	—	`e3d/write_mac.E3DWriter`	AVEVA macro files.
NGEOM	—	`ngeom/serialize.serialize_geometries`; `export.native_to_stp`, `native_to_glb`, `native_to_mesh`	Binary hand-off of `ada.geom` to adacpp. An object it cannot express raises `NativeExportUnsupported`, and the caller falls back to the Python writer for the whole model.

IFC round trip¶

sequenceDiagram autonumber participant U as User participant A as Assembly participant S as IfcStore participant W as IfcWriter / stream / native participant F as .ifc file U->>A: ada.from_ifc(path) A->>S: load_ifc_content_from_file S->>A: IfcReader → Beam / Plate / Shape / Pipe … U->>A: edit objects U->>A: to_ifc(path, writer=…) alt default A->>S: sync() → IfcWriter (per-object ChangeAction tracking) S->>F: save_to_file else writer="stream" A->>W: stream_assembly_to_ifc (bounded memory) W->>F: write else writer="native" A->>W: native_write_ifc (adacpp, via NGEOM) W->>F: write end

Finite element formats¶

ada/fem/formats/general.py is the dispatcher. FEATypes enumerates CODE_ASTER, CALCULIX, ABAQUS, SESAM, USFOS, OPENCOURANT, GMSH and XDMF. Each solver package has a config.py with a FrameworkConfig subclass naming its pre-processor (deck writer), executor and post-processor (results reader):

Solver	Package	Read deck	Write deck	Execute	Read results
Abaqus	`abaqus/`	`read_fem` (`.inp`)	`to_fem_abaqus`	`run_abaqus` (with FlexNet token gate)	`read_odb_pckle_file`
CalculiX	`calculix/`	—	`calculix_to_fem`	`run_calculix`	`read_from_frd_file_proto`
Code_Aster	`code_aster/`	`read_fem` (`.med`)	`to_fem_code_aster`	`run_code_aster`	`read_rmed_file`
Sesam	`sesam/`	`read_fem` (`.fem`)	`to_fem_sesam`	`run_sesam`	`read_sin_file` (`.SIN`; `.SIF` via `read_sif_file`)
Usfos	`usfos/`	—	`to_fem_usfos`	—	—
OpenCourant (explicit)	`opencourant/`	—	`to_fem` (`<name>_0000.rad` starter + `_0001.rad` engine)	`run_opencourant` (starter, then engine)	`read_opencourant_results` (`.radanim`)

Also present: mesh_io/ (meshio bridge: meshio_read_fem, meshio_to_fem, selected with FemConverters.MESHIO), vtu/, xdmf/ and ifc/ (to_ifc_fem: line and shell elements into an IFC file).

write_to_fem merges a multi-part model into one part with fem.concat.concatenate_fem_to_single_part before writing, except for Abaqus, which writes assemblies natively. FEA has the full analysis flow.