Backend And Adapter Primitives

Adapters map ArchAI semantics to external tools. They must declare what they can preserve.

GeoJSON is a GIS/web interchange adapter, not ArchAI’s internal geometry model. ArchAI’s internal graph remains path-addressed, unit-aware, CRS-aware, and frame-aware. See Coordinates And Formats.

Capability Shape

interface BackendCapabilities {
  siteData: {
    parcels: boolean;
    terrain: boolean;
    contours: boolean;
    zoningOverlays: boolean;
    georeferencing: boolean;
  };
  nativeElements: {
    building: boolean;
    floorPlate: boolean;
    wall: boolean;
    slab: boolean;
    roof: boolean;
    door: boolean;
    window: boolean;
    space: boolean;
  };
  hostedOpenings: boolean;
  customProperties: boolean;
  parametricObjects: boolean;
  meshGeometry: boolean;
  terrainMesh: boolean;
  bimSchedules: boolean;
  gisRoundTrip: boolean;
  roundTripImport: boolean;
}

Adapter Families

Adapter	Role
GeoJSON	Parcels, zoning overlays, context layers, web maps
JSON-FG	CRS-aware or richer feature exchange where GeoJSON is too narrow
WKT-CRS	CRS definitions and coordinate operations
PROJ / PROJJSON	Coordinate transformations
LandXML	Terrain and civil/survey data
DXF / DWG survey extraction	Survey lines and CAD references
CityGML	City/building context
Shapefile	GIS layers
OpenStreetMap	Roads, paths, amenities, context
Blender	Visual/procedural scene host
IFC	Open BIM exchange
USD	Scene composition
glTF	Web preview
Archicad	Native BIM host
Revit	Native BIM host

Semantic Loss Warning

Every adapter must warn when it cannot preserve a primitive.

{
  "backend": "blender",
  "targetPath": "buildings.b_001.elements.walls.w_101",
  "warning": "nativeWallSemanticsDropped",
  "preservedAs": "meshWithCustomProperties"
}