IfcIO 0.11.1

dotnet add package IfcIO --version 0.11.1
                    
NuGet\Install-Package IfcIO -Version 0.11.1
                    
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="IfcIO" Version="0.11.1" />
                    
For projects that support PackageReference, copy this XML node into the project file to reference the package.
<PackageVersion Include="IfcIO" Version="0.11.1" />
                    
Directory.Packages.props
<PackageReference Include="IfcIO" />
                    
Project file
For projects that support Central Package Management (CPM), copy this XML node into the solution Directory.Packages.props file to version the package.
paket add IfcIO --version 0.11.1
                    
#r "nuget: IfcIO, 0.11.1"
                    
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
#:package IfcIO@0.11.1
                    
#:package directive can be used in C# file-based apps starting in .NET 10 preview 4. Copy this into a .cs file before any lines of code to reference the package.
#addin nuget:?package=IfcIO&version=0.11.1
                    
Install as a Cake Addin
#tool nuget:?package=IfcIO&version=0.11.1
                    
Install as a Cake Tool

<p align="center"> <img src="docs/images/ifcio-banner.png" alt="IfcIO" width="640"> </p>

IfcIO

Docs NuGet Release License: MIT Platform

IfcIO is a fast, 100% managed .NET library and command line tool for building, reading, and exporting Industry Foundation Classes (.ifc, .ifczip) compliant with IFC2x3 and IFC4 without native dependencies.

Built clean-room under the IOExtend organization alongside RvtIO and NwcIO.

What it does

  • Reads and writes ISO 10303-21 STEP physical files compliant with IFC2x3 Coordination View V2.0 and modern compact IFC4 (IfcTriangulatedFaceSet).
  • Reconstructs complete spatial hierarchy (Project, Site, Building, Storeys), elements, properties, materials, and 3D meshes.
  • Direct conversion to binary glTF 2.0 (.glb), Wavefront OBJ, transparent .ifczip compression, and structured JSON.
  • Coordinates 4D construction scheduling (IfcWorkSchedule) and 5D cost budgeting (IfcCostSchedule) with temporal simulation and CBS rollups.
  • High-level, script-like IfcApi facade conforming to IfcOpenShell conventions (IfcApi.Sequence, IfcApi.Cost, IfcApi.Spatial, IfcApi.Root).
  • Collision detection, revision comparison, buildingSMART IDS 1.0 audit, and bidirectional BCF 2.1 archive container (BcfArchive).
  • Exports standalone, zero-dependency interactive 3D WebGL HTML viewers (.html).

Install

Install the command line tool:

dotnet tool install --global IfcIO.Cli

Add the library to a .NET project:

dotnet add package IfcIO

The library targets .NET 8 and .NET 10. It uses managed code without native dependencies or Windows-only APIs and supports Windows, Linux, and macOS.

Command line

Inspect, query, and export IFC models:

# Inspect model metadata, storeys, spaces, and systems
ifcio info Building.ifc --report

# Query elements matching IfcOpenShell-style selector
ifcio query Building.ifc "IfcWall[LoadBearing=TRUE]"

# Convert IFC to binary glTF 2.0 and Wavefront OBJ
ifcio export Building.ifc --glb scene.glb --obj scene.obj

# Compress or unpack .ifczip archives
ifcio pack Building.ifc -o Building.ifczip
ifcio unpack Building.ifczip -o Building.ifc

4D scheduling, 5D cost, and BCF coordination:

# 4D construction schedule temporal simulation and CSV export
ifcio schedule Building.ifc --sim-date 2026-06-01 --export-csv schedule.csv

# 5D cost breakdown and budget reporting
ifcio cost Building.ifc --export-csv cost.csv

# Inspect BCF 2.1 coordination archive topics and viewpoints
ifcio bcf Issues.bcfzip

# Run 3D geometric clash detection with proximity clustering
ifcio clash Arch.ifc Mep.ifc -o clashes.json --bcf clashes.bcfzip --group proximity

# Compare two model revisions (added, deleted, modified)
ifcio diff Baseline.ifc Revision.ifc -o changes.json --bcf changes.bcfzip

# Export standalone 3D WebGL HTML viewer with sectioning and measure tools
ifcio view Building.ifc -o viewer.html --grids grids.xml

Diagnostics and progress go to standard error. Run ifcio --help for the full list of options.

Library

Create an IFC4 model and save to STEP and glTF:

using IfcIO;
using IfcIO.Geometry;
using IfcIO.Schema;

// Create a new IFC4 model
var model = IfcModel.Create("Commercial Office", IfcSchema.Ifc4);
var storey = model.AddStorey("Level 1", elevation: 0.0);

// Add building element with geometry
var wall = storey.AddWall("Exterior Wall 1");
wall.PropertySets.Add(StandardPsets.WallCommon(loadBearing: true, fireRating: "REI 120"));

// Save directly to STEP, compressed .ifczip, and glTF 2.0
model.Save("Building.ifc");
model.SaveZip("Building.ifczip");
model.SaveGlb("Building.glb");

High-level 4D scheduling and 5D cost planning via IfcApi:

using IfcIO;
using IfcIO.Api;

var model = IfcModel.Open("Building.ifc");
var wall = model.FindElementByName("Exterior Wall 1");

// 4D construction schedule
var schedule = IfcApi.Sequence.AddWorkSchedule(model, "Master Schedule");
var task = IfcApi.Sequence.AddTask(model, schedule, "Wall Framing", new DateTime(2026, 2, 1), new DateTime(2026, 3, 1));
IfcApi.Sequence.AssignProcess(task, wall!);

// 5D cost breakdown
var budget = IfcApi.Cost.AddCostSchedule(model, "Base Budget", currency: "USD");
var costItem = IfcApi.Cost.AddCostItem(budget, "Masonry", unitRate: 150.0, quantity: 200.0);
IfcApi.Cost.AssignCostControl(costItem, wall!);

model.Save("Building_4D_5D.ifc");

See the public API for the supported surface and getting started guide for detailed workflows.

IfcIO.Scene (a separate package released with IfcIO, from IOScene 0.1.0 on) converts IFC models into IOScene scene documents for viewers and coordination tools; see the scene adapter page for usage and limits.

Documentation

The documentation site with API references and guides is at https://ioextend.github.io/IfcIO/. Ask DeepWiki offers an automatically generated overview of the repository.

Supported files

Reads and writes ISO 10303-21 STEP physical files conforming to IFC2x3 Coordination View V2.0 and IFC4 Design Transfer / Reference View, compressed PKZip .ifczip archives, and buildingSMART BCF 2.1 .bcfzip packages.

Limitations

  • Version 0.11.1 is a preview. The API can evolve before 1.0.
  • IFC5 (USD/JSON) is not yet supported.
  • Boolean mesh cutting evaluates planar CSG half-spaces; non-planar curved intersections are tessellated.

Scope and frozen features

IfcIO reads and writes IFC. The following extras are frozen: they get bug fixes only, no new features or options.

  • HTML viewer (IfcHtmlViewerExporter, ifcio view). Viewing will move to IOViewer through the IfcIO.Scene adapter over the shared IOScene model.
  • GLB and OBJ export (IfcGlbExporter, IfcObjExporter). A shared GLB writer is planned in IOScene.Formats.
  • Clash detection, measure, grids, diff, and BCF archives (IfcClashDetector, IfcClashGrouper, IfcMeasureEngine, IfcGridSystem, IfcDiffEngine, BcfArchive, BcfZipExporter). These will move to a planned IOCoord package.
  • IFC work-schedule (4D) sequence logic. It stays in IfcIO.

None of these replacements is published yet. The frozen features stay available and are removed no earlier than IfcIO 1.0, and only after a published replacement exists.

Build from source and tests

Use the .NET SDK selected by global.json, which specifies 10.0.100 with latestFeature roll-forward.

From the repository root:

dotnet build IfcIO.slnx -c Release
dotnet test

Contributing

See CONTRIBUTING.md and the Code of Conduct. Release changes are recorded in CHANGELOG.md.

Security

Report vulnerabilities through GitHub private vulnerability reporting in the repository's Security tab. Do not open public issues for security vulnerabilities. See SECURITY.md.

License and trademarks

IfcIO is licensed under the MIT License. Copyright © 2026 IOExtend.

buildingSMART and IFC are registered trademarks of buildingSMART International Ltd.

IfcIO is an independent implementation of the ISO 10303-21 STEP and buildingSMART specifications. No proprietary code or binaries are included.

Product Compatible and additional computed target framework versions.
.NET net8.0 is compatible.  net8.0-android was computed.  net8.0-browser was computed.  net8.0-ios was computed.  net8.0-maccatalyst was computed.  net8.0-macos was computed.  net8.0-tvos was computed.  net8.0-windows was computed.  net9.0 was computed.  net9.0-android was computed.  net9.0-browser was computed.  net9.0-ios was computed.  net9.0-maccatalyst was computed.  net9.0-macos was computed.  net9.0-tvos was computed.  net9.0-windows was computed.  net10.0 is compatible.  net10.0-android was computed.  net10.0-browser was computed.  net10.0-ios was computed.  net10.0-maccatalyst was computed.  net10.0-macos was computed.  net10.0-tvos was computed.  net10.0-windows was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.
  • net10.0

    • No dependencies.
  • net8.0

    • No dependencies.

NuGet packages (1)

Showing the top 1 NuGet packages that depend on IfcIO:

Package Downloads
IfcIO.Scene

Converts IFC models read by IfcIO into IOScene documents in metres with Z up, keeping GlobalIds, storeys, property sets, quantities and 4D schedules.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last Updated
0.11.1 405 11/13/2026
0.11.0 60 11/13/2026
0.10.0 774 11/11/2026
0.9.0 63 11/10/2026
0.8.0 53 11/10/2026
0.7.0 63 11/10/2026
0.6.0 57 11/10/2026
0.5.0 66 11/10/2026
0.4.0 63 11/10/2026
0.3.0 180 11/10/2026
0.2.0 59 11/10/2026
0.1.0 59 11/10/2026