Scroll to navigation

IfcConvert(1) IfcConvert(1)

NAME

IfcConvert - converts IFC files to various formats

IfcOpenShell IfcConvert 0.8.0 (OCC 7.8.1) Usage: IfcConvert [options] <input.ifc> [<output>]

Converts (the geometry in) an IFC file into one of the following formats:

.obj
WaveFront OBJ (a .mtl file is also created)
.stp
STEP Standard for the Exchange of Product Data
.igs
IGES Initial Graphics Exchange Specification
.xml
XML Property definitions and decomposition tree
.svg
SVG Scalable Vector Graphics (2D floor plan)
.cityjson
City JSON format for geospatial data
.ttl
TTL/WKT RDF Turtle with Well-Known-Text geometry
.ifc
IFC-SPF Industry Foundation Classes

If no output filename given, <input>.obj will be used as the output file.


Command line options:
display usage information
display version information
more verbose log messages. Use twice (-vv) for debugging level.
less status and progress output
output progress to stderr stream
answer 'yes' automatically to possible confirmation queries (e.g. overwriting an existing output file)
suppress possible progress bar type of prints that use carriage return
log format: plain or json
redirect log output to file

Geometry options:

Geometry kernel to use (opencascade, cgal, cgal-simple).
Number of parallel processing threads for geometry interpretation.
Centers the elements by applying the center point of all placements as an offset.Can take several minutes on large models.
Centers the elements by applying the center point of all mesh vertices as an offset.
Applies an arbitrary offset of form ’x;y;z' to all placements.
Applies an arbitrary quaternion rotation of form 'x;y;z;w' to all placements.
Specifies that the instances that match a specific filtering criteria are to be included in the geometrical output:
1)
’entities': the following list of types should be included. SVG output defaults to IfcSpace to be included. The entity names are handled case-insensitively.
2)
’layers': the instances that are assigned to presentation layers of which names match the given values should be included.
3)
’attribute <AttributeName>': products whose value for <AttributeName> should be included . Currently supported arguments are GlobalId, Name, Description, and Tag.

The values for 'layers' and 'arg' are handled case-sensitively (wildcards supported).--include and --exclude cannot be placed right before input file argument and only single of each argument supported for now. See also --exclude.

Same as --include but applies filtering also to the decomposition and/or containment (IsDecomposedBy, HasOpenings, FillsVoid, ContainedInStructure) of the filtered entity, e.g. --include+=arg Name "Level 1" includes entity with name "Level 1" and all of its children. See --include for more information.
Specifies that the entities that match a specific filtering criteria are to be excluded in the geometrical output.See --include for syntax and more details. The default value is ’--exclude=entities IfcOpeningElement IfcSpace'.
Same as --exclude but applies filtering also to the decomposition and/or containment of the filtered entity. See --include+ for more details.
Specifies a filter file that describes the used filtering criteria. Supported formats are '--include=arg GlobalId Spaces and tabs can be used as delimiters.Multiple filters of same type with different values can be inserted on their own lines. See --include, --include+, --exclude, and --exclude+ for more details.
Specifies a material file that describes the material object types will haveif an object does not have any specified material in the IFC file.
26 November 2025