IfcIO 0.1.0

There is a newer version of this package available.
See the version list below for details.
dotnet add package IfcIO --version 0.1.0
                    
NuGet\Install-Package IfcIO -Version 0.1.0
                    
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.1.0" />
                    
For projects that support PackageReference, copy this XML node into the project file to reference the package.
<PackageVersion Include="IfcIO" Version="0.1.0" />
                    
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.1.0
                    
#r "nuget: IfcIO, 0.1.0"
                    
#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.1.0
                    
#: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.1.0
                    
Install as a Cake Addin
#tool nuget:?package=IfcIO&version=0.1.0
                    
Install as a Cake Tool

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

IfcIO

IfcIO is a fast, 100% managed .NET library for building, reading, and exporting Industry Foundation Classes (.ifc) files compliant with IFC2x3 Coordination View V2.0 and IFC4 Design Transfer / Reference View without third-party dependencies or native code.

Built clean-room under the IOExtend organization as the shared open-standards IFC foundation for AEC/BIM projects (including NwcIO and RvtIO).


Features

  • ISO 10303-21 Physical File Serializer & Reader (StepWriter / StepReader):
    • Full support for ISO-10303-21; physical file exchange structure (HEADER, DATA, ENDSEC).
    • Strict character escaping: standard Unicode \X2\HHHH...\X0\ for Cyrillic and international parameter names, single quotes '', backslashes \\.
    • Resilient tokenization and querying of STEP entities by class (OfType<StepEntity>).
  • buildingSMART 22-Character GlobalId (IfcGuid):
    • Standard base64-like buildingSMART encoding (0-9, A-Z, a-z, _, $).
    • Bidirectional conversion between 128-bit .NET Guid and 22-character IFC GlobalId.
    • Deterministic GUID generation via SHA-256 namespace hashing for elements and models.
  • 3D Faceted BRep Geometry (IfcFacetedBrep):
    • Encodes 3D meshes as IfcFacetedBrep → IfcClosedShell → IfcFace → IfcFaceOuterBound → IfcPolyLoop → IfcCartesianPoint.
    • Vertex deduplication via shared per-mesh IfcCartesianPoint coordinates.
  • BIM Spatial Containment:
    • Standard spatial aggregation: IfcProject → IfcSite → IfcBuilding → IfcBuildingStorey via IfcRelAggregates.
    • Elements assigned to storeys via IfcRelContainedInSpatialStructure.
  • Semantic Classification & Properties:
    • Automatic classification for standard BIM entities: IfcWall, IfcSlab, IfcColumn, IfcBeam, IfcReinforcingBar, IfcWindow, IfcDoor, IfcFooting, IfcStair, IfcRailing, IfcRoof, IfcPipeSegment, IfcDuctSegment, IfcBuildingElementProxy.
    • Property sets (IfcPropertySet, IfcPropertySingleValue) with typed values (IfcText, IfcInteger, IfcReal, IfcBoolean).
    • Surface styles and materials (IfcSurfaceStyle, IfcSurfaceStyleShading, IfcColourRgb, IfcStyledItem).
  • Zero Dependencies: Pure C# targeting .NET 8 and .NET 10.

Install

Add the package to your .NET project:

dotnet add package IfcIO

Library Usage (C#)

Creating and Exporting an IFC Model

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

// Create model (IFC2X3 or IFC4)
var model = IfcModel.Create("Residential Building Block 1", IfcSchema.Ifc2x3);
model.Author = "mahach666";
model.Organization = "IOExtend";

// Add storeys
var floor1 = model.AddStorey("Level 1", elevation: 0.0);
var floor2 = model.AddStorey("Level 2", elevation: 3300.0);

// Materials & colors
var concrete = new IfcMaterial { Name = "Concrete B25", R = 0.72, G = 0.72, B = 0.75 };

// Add 3D polygon mesh element
var vertices = new IfcVector3[]
{
    new(0, 0, 0),
    new(2000, 0, 0),
    new(2000, 200, 0),
    new(0, 200, 0),
    new(0, 0, 2800),
    new(2000, 0, 2800),
    new(2000, 200, 2800),
    new(0, 200, 2800)
};
var indices = new int[]
{
    0, 2, 1, 0, 3, 2, // bottom
    4, 5, 6, 4, 6, 7, // top
    0, 1, 5, 0, 5, 4, // front
    1, 2, 6, 1, 6, 5, // right
    2, 3, 7, 2, 7, 6, // back
    3, 0, 4, 3, 4, 7  // left
};

var wall = model.AddMesh("Стена монолитная 200", vertices, indices, concrete, floor1);

// Attach Property Sets
var pset = wall.GetOrCreatePropertySet("Pset_WallCommon");
pset.Add("LoadBearing", true);
pset.Add("Thickness", 200.0);
pset.Add("FireRating", "REI 120");

// Save to IFC physical file
model.Save("Building.ifc");

Parsing an Existing IFC File

using IfcIO.Core;

// Read STEP ISO-10303-21 file
var step = StepReader.Read("Building.ifc");

Console.WriteLine($"Schema:      {step.Schema}");
Console.WriteLine($"Description: {step.Description}");
Console.WriteLine($"Entities:    {step.Entities.Count}");

// Query elements by IFC type
foreach (var wall in step.OfType("IFCWALL"))
{
    Console.WriteLine($"Wall #{wall.Id}: {wall.RawArgs}");
}

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