Ara3D.BimOpenSchema.IO 1.6.1

📚 Ara3D-SDK

Ara3D-SDK is a collection of open-source C# libraries for AEC (Architecture, Engineering, and Construction) workflows. Use it standalone, or to extend and customize the Ara 3D Studio desktop application.

Designed for high performance and scalability, the libraries handle massive 3D data sets in real-time. Core and geometry packages target net8.0 and run cross-platform; file I/O and the full SDK target net8.0-windows.

📁 Repository Structure

• artifacts/ — built NuGet packages (gitignored; output of pack.bat)
• apps/ — standalone desktop apps (e.g. BOS Browser)
• data/ — testing data
• deprecated/ — projects that are no longer being built or maintained
• examples/ — sample applications and usage examples
• ext/ — Windows-only SDK extensions (IFC loader, WPF helpers)
• integrations/ — optional third-party adapters (e.g. Assimp)
• plugins/ — host plug-ins (Bowerbird, Revit add-ins)
• plato-src/ — Plato source for core numerical and geometry types
• src/ — supported SDK libraries and NuGet meta-packages
• tests/ — NUnit projects for unit, regression, and developer testing
• vendor/ — required third-party libraries
• toolchain/ — Plato parsing and code-generation tools (unsupported)

📦 NuGet packages

Current version: 1.6.1 (set by Ara3DVersion in Directory.Build.props).

All published packages share that version. Bump with bump-version.bat patch|minor|major|X.Y.Z, then build and pack:

build.bat Release
pack.bat

Packages are written to artifacts/ (gitignored). Only src/ and ext/ libraries are packed — see build/packages.txt (nothing under toolchain/, including Parakeet). Dependency diagrams: docs/PACKAGES.md. Release workflow: docs/NUGET_RELEASE.md.

Meta-packages

Meta-packages are dependency-only bundles (no source of their own). Pick the smallest tier that fits your app:

Ara3D.SDK  (net8.0-windows — full Windows stack)
├── Ara3D.SDK.Core            net8.0 — cross-platform foundation
├── Ara3D.SDK.Geometry        net8.0 — meshes, models, SIMD math
├── Ara3D.SDK.IO              net8.0-windows — file formats, BOS, IFC
├── Ara3D.Studio.API          Studio plug-in API
└── Ara3D.Utils.Wpf           WPF helpers (ext/)

Each library below is also published on its own at the same version. Per-project READMEs: src/README.md.

Ara3D.SDK.Core (net8.0)

Ara3D.SDK.Geometry (net8.0)

Ara3D.SDK.IO (net8.0-windows)

Ara3D.SDK (net8.0-windows) — all three meta-packages above, plus:

Not published to NuGet

These repo folders are built locally but excluded from meta-packages and build/packages.txt:

• plugins/ — Bowerbird, Revit add-ins
• apps/ — BOS Browser
• integrations/ — Assimp loader
• wip/ — work in progress (e.g. Domo)
• toolchain/ — dev tools (Parakeet, Plato, IfcTypeGen); IsPackable=false, not in packages.txt

📜 License

Ara3D-SDK is licensed under the MIT License.

🖇️ Dependencies

Most library packages have zero external NuGet dependencies. The exceptions:

Ara3D.IfcLoader also ships the native web-ifc-library.dll from vendor/ (not a NuGet package). See docs/PACKAGES.md for the full dependency graph.

Test projects and samples are Windows-specific and use NUnit 3. Auto-generated code from Plato uses projects in toolchain/; they are not run automatically and are not currently supported.

🗂️ Projects

All supported libraries live under src/. See the src/ project index for per-project READMEs grouped by category (geometry, I/O, BIM, Studio, utilities).

Install via a meta-package (see NuGet packages above) or reference individual library projects from src/.

🤝 Contributing

We welcome contributions of all kinds—bug fixes, features, documentation, and more!

Before submitting a pull request:

• Familiarize yourself with the code base
• Follow the existing style and architecture
• For significant changes, please open an issue first

Coding guidelines and AI agents

Coding conventions and the preferred development workflow are documented in AGENTS.md, with tracked improvements logged in docs/TECHNICAL_DEBT.md. Read these before making changes (they apply to AI agents and humans alike).

Use the helper scripts to build and test:

build.bat              :: build the solution (Debug)
test.bat               :: run the full test suite (includes Slow tests)
test.bat fast          :: run all areas, skip Slow file-I/O tests
test.bat geometry      :: run only one area's tests (all | sdk | geometry | bim | devtools | knownissues)
test.bat geometry fast :: run one area, skip Slow tests
test.bat geometry Delaunay   :: run tests in an area matching a name substring
test.bat knownissues   :: run documented known-broken behavior tests (opt-in only)
pack.bat               :: pack all NuGet packages from build/packages.txt (Release)
release.bat            :: build supported SDK surface, run scoped tests, then pack
bump-version.bat patch :: bump Ara3DVersion in Directory.Build.props
publish-nuget.bat smoke :: build, test, pack, and run NuGet integration tests (no push)
release-nuget.bat patch :: full NuGet release (bump, smoke, commit, tag, publish)
save.bat "message"      :: commit without pushing

Script cheat sheet: docs/WORKFLOWS.md.
NuGet release: docs/NUGET_RELEASE.md.

Known-issues tests are intentionally excluded from default and release test runs. They document bugs or incomplete behavior that should fail until the underlying issue is fixed.

Let's build something amazing together 🚀

🐞 Issues and Feature Requests

Found a bug? Have a question? Want to suggest a feature for either the SDK or Ara 3D Studio?

👉 Open an issue and let us know!

🔗 Related Projects

• Ara3D.Plato – A domain-specific programming language for math and geometry