Glassvision/IfcOpenShell
1
0
Fork 0
mirror of https://github.com/IfcOpenShell/IfcOpenShell.git synced 2026-09-21 23:50:59 +00:00
Code Issues Packages Projects Releases Wiki Activity

bbim doc: fix list indentation

Browse Source
This commit is contained in:
Dirk Olbrich
2023-11-06 21:45:55 +01:00
parent e602c3b68b
commit fb55077a86
1 changed files with 134 additions and 137 deletions
Download Patch File Download Diff File Expand all files Collapse all files
src/blenderbim/docs/blenderbim/scene.rst
+134 -137
View File
@@ -10,172 +10,169 @@ Building Information Modeling Panel
System Setup System Setup
^^^^^^^^^^^^ ^^^^^^^^^^^^
* **Quick Project Setup** - this will create a basic spatial tree. It will * **Quick Project Setup** - this will create a basic spatial tree. It will
create a tree of collections with the structure ``IfcProject > IfcSite > create a tree of collections with the structure ``IfcProject > IfcSite >
IfcBuilding > IfcStorey`` This is merely for convenience instead of having to IfcBuilding > IfcStorey`` This is merely for convenience instead of having to
create it all by yourself, since all IFC exports require a valid spatial create it all by yourself, since all IFC exports require a valid spatial
tree. You can see the tree of collections in the outliner when this is done. tree. You can see the tree of collections in the outliner when this is done.
* **Schema Directory** - this folder stores the current IFC schema. You can * **Schema Directory** - this folder stores the current IFC schema. You can
download different schemas from the buildingSMART website. Unless you are an download different schemas from the buildingSMART website. Unless you are an
IFC guru, you probably shouldn't touch this. BlenderBIM recognises different IFC guru, you probably shouldn't touch this. BlenderBIM recognises different
IFC data based on what is provided in this schema folder. It defaults to the IFC data based on what is provided in this schema folder. It defaults to the
``{{BLENDER_ADDONS_DIR}}/blenderbim/schema/`` folder, which is prepackaged ``{{BLENDER_ADDONS_DIR}}/blenderbim/schema/`` folder, which is prepackaged
with the IFC4 schema. This is known as the ``{SCHEMA_DIR}``. with the IFC4 schema. This is known as the ``{SCHEMA_DIR}``.
* **Data Directory** - the data directory holds the auxiliary data related to * **Data Directory** - the data directory holds the auxiliary data related to
your IFC model. Examples include related property definitions, documents, and your IFC model. Examples include related property definitions, documents, and
classification systems. Each project should have its own data directory. It classification systems. Each project should have its own data directory. It
defaults to the data directory in the defaults to the data directory in the
``{{BLENDER_ADDONS_DIR}}/blenderbim/data/`` folder, which comes with some ``{{BLENDER_ADDONS_DIR}}/blenderbim/data/`` folder, which comes with some
example preset data. You are encouraged to copy this template and set your example preset data. You are encouraged to copy this template and set your
own. This is known as the ``{DATA_DIR}``. own. This is known as the ``{DATA_DIR}``.
Software Identity Software Identity
^^^^^^^^^^^^^^^^^ ^^^^^^^^^^^^^^^^^
* **GlobalId** - this field let's you enter an IFC element's ``GlobalId``. It * **GlobalId** - this field let's you enter an IFC element's ``GlobalId``. It
must be in the 22-character encoded form. must be in the 22-character encoded form.
* **Select GlobalId** - this will select an element that has the same * **Select GlobalId** - this will select an element that has the same
``GlobalId`` attribute as what you have specified, based on what is currently ``GlobalId`` attribute as what you have specified, based on what is currently
visible in the scene. visible in the scene.
IFC Categorisation IFC Categorisation
^^^^^^^^^^^^^^^^^^ ^^^^^^^^^^^^^^^^^^
* **IFC Class** - this dropdown lets you pick from a list of all non-abstract * **IFC Class** - this dropdown lets you pick from a list of all non-abstract
children of ``IfcElement`` and ``IfcSpatialStructureElement`` children of ``IfcElement`` and ``IfcSpatialStructureElement``
* **IFC Predefined Type** - this dropdown lets you pick from an enumeration of * **IFC Predefined Type** - this dropdown lets you pick from an enumeration of
valid ``PredefinedType`` values for the currently selected *IFC Class*. It valid ``PredefinedType`` values for the currently selected *IFC Class*. It
changes dynamically with the currently selected *IFC Class*. changes dynamically with the currently selected *IFC Class*.
* **IFC Userdefined Type** - this field lets you enter a value for a user * **IFC Userdefined Type** - this field lets you enter a value for a user
defined type. It is stored as the ``ObjectType`` attribute of an defined type. It is stored as the ``ObjectType`` attribute of an
``IfcProduct``. It is only set when the **IFC Predefined Type** is set to ``IfcProduct``. It is only set when the **IFC Predefined Type** is set to
``USERDEFINED``, otherwise it is ignored. It is recommended to make this ``USERDEFINED``, otherwise it is ignored. It is recommended to make this
value uppercase and alphabetic, to match the conventions for the value uppercase and alphabetic, to match the conventions for the
``PredefinedType`` enumeration. ``PredefinedType`` enumeration.
* **Assign Class** - this applies the active *IFC Class*, *IFC Predefined Type* * **Assign Class** - this applies the active *IFC Class*, *IFC Predefined Type*
and *IFC Userdefined Type* to any selected objects. and *IFC Userdefined Type* to any selected objects.
* **Select Class** - this will select any objects that are currently visible * **Select Class** - this will select any objects that are currently visible
that also have the same IFC class as the currently active *IFC Class* that also have the same IFC class as the currently active *IFC Class* dropdown.
dropdown. * **Select Type** - same as *Select Class*, but it also filters by the
* **Select Type** - same as *Select Class*, but it also filters by the currently active *IFC Predefined Type* dropdown, as well as the *IFC
currently active *IFC Predefined Type* dropdown, as well as the *IFC Userdefined Type* field.
Userdefined Type* field.
Property Sets Property Sets
^^^^^^^^^^^^^ ^^^^^^^^^^^^^
- **Pset Name** - this lets you select from a list of available property set - **Pset Name** - this lets you select from a list of available property set
types. The list is derived from the folders in types. The list is derived from the folders in
``{DATA_DIR}/pset``. Each folder name corresponds to a property set name. If ``{DATA_DIR}/pset``. Each folder name corresponds to a property set name. If
you want to assign properties to an object based on an IFC standard pset, you want to assign properties to an object based on an IFC standard pset,
just create a new folder with the same name as the pset. You can also create just create a new folder with the same name as the pset. You can also create
your own custom property sets, so long as the folder name does not start with your own custom property sets, so long as the folder name does not start with
``Pset_``, as these are reserved for official IFC property sets. ``Pset_``, as these are reserved for official IFC property sets.
- **Pset File** - this lets you select from a list of available property set - **Pset File** - this lets you select from a list of available property set
data. The available property sets depends on the currently selected *PSet data. The available property sets depends on the currently selected *PSet
Name* dropdown. Each property set is represented by a ``.csv`` file inside Name* dropdown. Each property set is represented by a ``.csv`` file inside
``{DATA_DIR}/pset/{PSET_NAME}/``. You can create your own ``.csv`` files ``{DATA_DIR}/pset/{PSET_NAME}/``. You can create your own ``.csv`` files
with any software, where each line contains a property name and property with any software, where each line contains a property name and property
value pair. Data types are automatically converted based on the property set value pair. Data types are automatically converted based on the property set
templates defined in ``{SCHEMA_DIR}``. If the pset is part of an official IFC templates defined in ``{SCHEMA_DIR}``. If the pset is part of an official IFC
standard, you can only use property names that are part of the IFC standard. standard, you can only use property names that are part of the IFC standard.
If you want to add your own custom properties, you will need to create your If you want to add your own custom properties, you will need to create your
own *PSet Name* folder first, and then you can put in your own ``.csv`` file own *PSet Name* folder first, and then you can put in your own ``.csv`` file
which contains any property names and values that you want. which contains any property names and values that you want.
- **Assign Pset** - this assigns the currently selected *Pset file* to any - **Assign Pset** - this assigns the currently selected *Pset file* to any
selected objects. The assigned data will then be visible in the *Object selected objects. The assigned data will then be visible in the *Object
Properties*. This only assigns a link to the ``.csv`` containing the data, so Properties*. This only assigns a link to the ``.csv`` containing the data, so
you can change the data in the ``.csv`` file and that will automatically you can change the data in the ``.csv`` file and that will automatically
propagate to all assigned elements when an IFC is exported, without needing propagate to all assigned elements when an IFC is exported, without needing
to reassign the data. to reassign the data.
- **Unassign Pset** - this removes the link to the property set ``.csv`` - **Unassign Pset** - this removes the link to the property set ``.csv``
file for all currently selected objects. file for all currently selected objects.
Aggregates Aggregates
^^^^^^^^^^ ^^^^^^^^^^
- **Aggregate Class** - this lets you select what type of class you want an - **Aggregate Class** - this lets you select what type of class you want an
aggregate of parts to be. aggregate of parts to be.
- **Aggregate name** - this lets you set the name of an aggregate that you can - **Aggregate name** - this lets you set the name of an aggregate that you can
can create. can create.
- **Create Aggregate** - this will create a new aggregate from one or more - **Create Aggregate** - this will create a new aggregate from one or more
currently selected objects. The selected objects will be moved out of the currently selected objects. The selected objects will be moved out of the
spatial tree into an ``IfcRelAggregates/*`` collection. Then, a collection spatial tree into an ``IfcRelAggregates/*`` collection. Then, a collection
instance will be created to represent the aggregation, and will be placed in instance will be created to represent the aggregation, and will be placed in
the current location of the spatial tree, and the The parts will then be the current location of the spatial tree, and the The parts will then be
hidden so only the whole composition (i.e. the aggregate object) will be hidden so only the whole composition (i.e. the aggregate object) will be shown.
shown. - **Explode Aggregate** - this does the opposite of *Create Aggregate*, and
- **Explode Aggregate** - this does the opposite of *Create Aggregate*, and will remove the aggregation.
will remove the aggregation. - **Edit Aggregate** - this will hide the collection instance that represents
- **Edit Aggregate** - this will hide the collection instance that represents the aggregate object, and show all of the individual parts. This allows you
the aggregate object, and show all of the individual parts. This allows you to select and modify the aggregate parts.
to select and modify the aggregate parts. - **Save Aggregate** - this does the opposite of *Edit Aggregate*.
- **Save Aggregate** - this does the opposite of *Edit Aggregate*.
IFC Classifications Panel IFC Classifications Panel
------------------------- -------------------------
- **Classification** - this lets you select which classification system you'd - **Classification** - this lets you select which classification system you'd
like to use. The list of possible classification systems is derived from the like to use. The list of possible classification systems is derived from the
``{DATA_DIR}/class/classifications.csv`` file. By default, BlenderBIM comes ``{DATA_DIR}/class/classifications.csv`` file. By default, BlenderBIM comes
with Uniclass 2015 and Omniclass. If you need another classification system, with Uniclass 2015 and Omniclass. If you need another classification system,
you can add it to this ``.csv`` file. you can add it to this ``.csv`` file.
- **Reference** - this lets you select a single classification reference item, - **Reference** - this lets you select a single classification reference item,
filtered depending on the currently active *Classification*. The list is filtered depending on the currently active *Classification*. The list is
derived from the ``{DATA_DIR}/class/references.csv`` file. Out of the box, derived from the ``{DATA_DIR}/class/references.csv`` file. Out of the box,
BlenderBIM only lists a single Uniclass reference as an example. It is BlenderBIM only lists a single Uniclass reference as an example. It is
advised to make a list of all the references you require for a project and advised to make a list of all the references you require for a project and
add it to this ``.csv`` file. add it to this ``.csv`` file.
- **Assign Classification** - this assigns the currently active *Reference* to - **Assign Classification** - this assigns the currently active *Reference* to
all of the selected objects. You can see the results in the *Object all of the selected objects. You can see the results in the *Object
Properties* pane. Properties* pane.
- **Unassign Classification** - this removes the currently active *Reference* - **Unassign Classification** - this removes the currently active *Reference*
in all of the selected objects. in all of the selected objects.
IFC Owner History Panel IFC Owner History Panel
----------------------- -----------------------
- **Person** - this lets you select who you are. The values are derived from - **Person** - this lets you select who you are. The values are derived from
the ``{DATA_DIR}/owner/person.json`` file, particularly the the ``{DATA_DIR}/owner/person.json`` file, particularly the
``Identification`` attribute, which is mandatory and a requirement in COBie ``Identification`` attribute, which is mandatory and a requirement in COBie
data. You are encouraged to edit this file to add your own details. This data. You are encouraged to edit this file to add your own details. This
information will be stored in the IFC file as part of the owner history to information will be stored in the IFC file as part of the owner history to
keep track of any objects which you edit. You will also be recorded as the keep track of any objects which you edit. You will also be recorded as the
author of the IFC file. author of the IFC file.
- **Organisation** - this lets you select which organisation you are part of. - **Organisation** - this lets you select which organisation you are part of.
The values are derived from the ``{DATA_DIR}/owner/organisation.json`` file, The values are derived from the ``{DATA_DIR}/owner/organisation.json`` file,
in particular the ``Name`` attribute, which is mandatory and a requirement in in particular the ``Name`` attribute, which is mandatory and a requirement in
COBie data. You are encouraged to edit this file to add your own organisation COBie data. You are encouraged to edit this file to add your own organisation
details. This information will be stored in the IFC file as part of the details. This information will be stored in the IFC file as part of the
owner history to keep track of any objects which you edit. The organisation owner history to keep track of any objects which you edit. The organisation
will also be recorded as the author of the IFC file. will also be recorded as the author of the IFC file.
IFC Geometric Representation Contexts Panel IFC Geometric Representation Contexts Panel
------------------------------------------- -------------------------------------------
- **Has Model Context** - enabling this will allow you to export geometric data - **Has Model Context** - enabling this will allow you to export geometric data
related to the model view of your BIM data. This is generally 3D related to the model view of your BIM data. This is generally 3D
representations. It may also contain wireframe representations such as an representations. It may also contain wireframe representations such as an
Axis model for structural members. This defaults to being enabled, as most Axis model for structural members. This defaults to being enabled, as most
people want to export model geometry. people want to export model geometry.
- **Available Subcontexts** - this lets you select a possible subcontext to - **Available Subcontexts** - this lets you select a possible subcontext to
be used underneath the Model context. be used underneath the Model context.
- **Available Target Views** - subcontexts may have a particular target view, - **Available Target Views** - subcontexts may have a particular target view,
which you can set here. which you can set here.
- **Add Subcontext** - This will add a new subcontext based on the currently - **Add Subcontext** - This will add a new subcontext based on the currently
selected *Available Subcontext* and *Available Target View*. selected *Available Subcontext* and *Available Target View*.
- **Subcontext Name** - for each subcontext you have added, it will show - **Subcontext Name** - for each subcontext you have added, it will show
you the subcontext name. By default, the ``Body`` subcontext is added, you the subcontext name. By default, the ``Body`` subcontext is added,
as most people want to export the body geometry of products in their BIM as most people want to export the body geometry of products in their BIM data.
data. - **Subcontext Target View** - same as *Subcontext Name*, but shows the
- **Subcontext Target View** - same as *Subcontext Name*, but shows the target view. By default, the ``MODEL_VIEW`` target view is added, as most
target view. By default, the ``MODEL_VIEW`` target view is added, as most people will be viewing the model geometry of your BIM data.
people will be viewing the model geometry of your BIM data. - **Remove Subcontext** - this will remove the subcontext.
- **Remove Subcontext** - this will remove the subcontext.
- **Has Plan Context** - the same as *Has Model Context*, but it lets you add - **Has Plan Context** - the same as *Has Model Context*, but it lets you add
subcontexts and target views related to the ``PLAN`` context of your BIM subcontexts and target views related to the ``PLAN`` context of your BIM
data. This is usually plans, sections, RCPs, and other documentation views. data. This is usually plans, sections, RCPs, and other documentation views.