diff --git a/src/blenderbim/docs/users/exploring_an_ifc_model.rst b/src/blenderbim/docs/users/exploring_an_ifc_model.rst index e52e10a329..7cb0346235 100644 --- a/src/blenderbim/docs/users/exploring_an_ifc_model.rst +++ b/src/blenderbim/docs/users/exploring_an_ifc_model.rst @@ -206,6 +206,12 @@ classification. In this case, it distinguishes our object as a roof slab, compared to other types of slabs. The **Predefined Type** is optional so you may not see it all the time. +.. seealso:: + + You can use the `Search IFC Class + `__ tool to learn the correct + classes and predefined types you should see. + Press the **Select Icon** to select all objects that are of the same **IfcSlab** **Class**. Then, you can isolate these elements by going to ``Object > Show/Hide > Hide Unselected`` (hotkey ``Shift-H``). To show all elements again, you can use @@ -298,7 +304,23 @@ You can find **Quantities** in the **IFC Quantity Sets** subpanel. Finding the location of objects ------------------------------- -TODO +Every object in the built environment has a location in the world. For example, +a chair will be located in a space, and a wall is typically located in a +building storey. You've already seen this hierarchy of spaces in the +**Outliner** panel, where an IFC project is broken down into site, building, +storeys, and spaces. + +Sometimes, objects may have multiple relevant locations, such +as a multi-storey column which can be related to multiple building storeys. +Even in these cases, IFC enforces one location to be its primary +location, known as its **Spatial Container**. + +If you click on any object, you can see its location in the **IFC Spatial +Container** subpanel in the **Object Properties** tab. + +Press the **Select Icon** to select all objects that are in the same location. + +.. image:: spatial-container.png Checking construction types --------------------------- @@ -359,14 +381,69 @@ grouped into categories like steel, concrete, brick, block, and so on. We can see a list of **Materials** used in the project in the **IFC Materials** subpanel in the **Scene Properties** tab. -TODO +Press the **Select Icon** to select all objects that are of the selected +material. + +.. image:: materials.png Taking simple measurements -------------------------- -TODO +The simplest form of measurement is the one that's already taken for you. The +**Viewing attributes and properties** section describes how to view +pre-calculated **Quantities**. + +Sometimes, you may wish to take manual measurements yourself. To view the +overall dimensions of an object, first select an object, then expand out the +viewport **Sidebar**. + +.. image:: viewport-sidebar.png + +In the **Item** tab, you can find the X, Y, and Z overall **Dimensions** of the +currently selected object. + +.. image:: viewport-dimensions.png + +Another way to manually measure from two points is to use the **Measure** tool. +First, press the **Snap Icon** to enable snapping. Then choose snap targets in +the **Snap Menu** in the top middle section of the **Viewport** panel. + +.. image:: snap-targets.png + +.. tip:: + + It is recommended to choose multiple snap targets, like **Vertex**, **Edge**, and + **Face**, and **Edge Center**. You can use the ``Shift`` key to select + multiple snap targets. For example, the **Face** snap target means that your + measurements will automatically snap to the nearest object's surface. + +Now that you have configured snapping, press the **Measure Tool Icon** on the +left of the **Viewport** panel. **Click** and **Drag** in the 3D viewport to +take a measurement. A circle will appear guiding the first point of your +measurement. While **Dragging**, press the ``X`` key to lock the measurement +line along the X axis. Alternatively, press the ``Y`` or ``Z`` key to lock the +measurement line along the Y or Z axis. Let go of the mouse to finish your +measurement. + +.. image:: measure-tool.png + +To delete a measurement, just click on one point of the measurement, and press +the ``Delete`` key. You can also click and drag the ends of your measurement +lines to measure to another location. What else is there? ------------------- -TODO +Congratulations, and welcome to the digital built environment! + +We've barely scratched the surface of the data and relationships available in an +IFC model. We've yet to cover documents and drawings, clearance zones, tasks, +cost items, structural loads and forces, analytical models, distribution system +connectivity, energy analysis, rendering textures, and so much more. Our built +environment and its relationships are vast and complex and it is exciting that +you can join us on its digital journey! + +Please do not hesitate to reach out with any questions. + +- `OSArch live chat `__ +- `OSArch community forum `__ diff --git a/src/blenderbim/docs/users/materials.png b/src/blenderbim/docs/users/materials.png new file mode 100644 index 0000000000..8abaf46a04 Binary files /dev/null and b/src/blenderbim/docs/users/materials.png differ diff --git a/src/blenderbim/docs/users/measure-tool.png b/src/blenderbim/docs/users/measure-tool.png new file mode 100644 index 0000000000..05a3ff444c Binary files /dev/null and b/src/blenderbim/docs/users/measure-tool.png differ diff --git a/src/blenderbim/docs/users/snap-targets.png b/src/blenderbim/docs/users/snap-targets.png new file mode 100644 index 0000000000..4a58a6193d Binary files /dev/null and b/src/blenderbim/docs/users/snap-targets.png differ diff --git a/src/blenderbim/docs/users/spatial-container.png b/src/blenderbim/docs/users/spatial-container.png new file mode 100644 index 0000000000..a8c2c74e83 Binary files /dev/null and b/src/blenderbim/docs/users/spatial-container.png differ diff --git a/src/blenderbim/docs/users/viewport-dimensions.png b/src/blenderbim/docs/users/viewport-dimensions.png new file mode 100644 index 0000000000..52dda47f68 Binary files /dev/null and b/src/blenderbim/docs/users/viewport-dimensions.png differ diff --git a/src/blenderbim/docs/users/viewport-sidebar.png b/src/blenderbim/docs/users/viewport-sidebar.png new file mode 100644 index 0000000000..7931d22a93 Binary files /dev/null and b/src/blenderbim/docs/users/viewport-sidebar.png differ