Editing Regard3D+Blender+FreeCAD workflow

{{Workflow Example}}
[https://community.osarch.org/discussion/474/floss-workflow-with-regard3d-blender-freecad#latest Forum's discussion].

This wiki present a [[FLOSS]] workflow for an architecture job (documentation and registration of an existing house renovation), that involve the use of Regard3D, Blender and FreeCAD for Geometry Scanning, BIM modeling and CAD documentation.
This workflow is fully multi-platform (the three programs run on Windows, Mac, Linux).

[[File:FLOSS SummaryWorkflow.png|700 px]]

== Tools ==
As a basic requirement for this tutorial, it is necessary to have a medium level of knowledge about the tools used in this workflow. This tutorial is about the workflow, not about each tool.


[http://www.regard3d.org/ Regard3D]

[[Blender]] (v2.8)

[[Point_Cloud_Visualizer|Point Cloud Visualiser]]

[[FreeCAD|FreeCAD]] (v0.19)

== Geometry scanning ==
The idea is to gather geometry data of an existing building for further 3D modeling process. For this purpose, we will use open source photogrammetry software.

===== Creation of data set of photos=====
# Recommendation: Camera's metadata must include focus lens (you can add that information manually later). 
# Shoot several photos of the building with a camera or smartphone. In general it is good to take more than 60-80 images from different angles. Look for info about photogrammetry good practices.

===== Point cloud generation with Regard3D. =====
# For this step it is used Regard3D, but there are other photogrammetry programs that can be used. Refers to [[AEC_Free_Software_directory|Software Directory]] for more options.
# Import image set. 
# Generate point clouds of the model (see [https://www.regard3d.org/index.php/documentation/tutorial tutorial] ).
# Export point cloud file (*.ply). You can save several point clouds files to cover all facades of the building.
# Mesh generation (Optional). Also, you can generate mesh surfaces with the point clouds. But, for this case I found efficient enough to work only with the point clouds. 


[[File:Regard3d.png|700px|none]]

== 3D Mesh modeling ==

Volumetric mesh reconstruction with Blender + point cloud visualizer (0.9.3v).
Using Blender you can visualise the point cloud and generate a volumetric mesh to get the general dimensions and shapes of the building. However, this step is optional, because you can directly import the point clouds into FreeCAD. Anyway, the point cloud visualiser has more manipulation options than FreeCAD.

===== Importing the point clouds =====
# Install [https://blendermarket.com/products/pcv Point Cloud Visualiser] add-on (0.9.3v is free). Here [https://jakubuhlik.com/docs/pcv/docs.html more documentation]. But these are basic steps to load and work in Blender:
# In blender create a empty object.
# Import a point cloud file in the empty object, using PCV.
# Edit the point cloud position and scale it, if it is necessary (use Enable Edit Mode, in the PCV panel).
# Export new edited point cloud in the empty object, to save the edition (use Export PLY in the PCV panel). 
# When you open the blender file, select the empty object and load the last exported PLY file, to display the edited point cloud.


[[File:Blender PCV.png|500px|none]]

[[File:Blender pointcloud.png|700px|none]]

===== Geometry modeling =====
# Model the main volumes with Blender, using the points as reference. 
# Option 1) Once you have the 3D model complete, you could convert the Blender meshes into BIM models using [https://blenderbim.org/ BlenderBIM] add-on.
#* Install BlenderBIM Add-on
#* Set the meshes as BIM objects
#* Export the model as IFC file

# Option 2) Once you finish with the 3D modeling, export the model as a simple mesh file (OBJ, STL...).

 
[[File:Blenderpointcloud.png|700px|none]]

== BIM modeling ==

Develop a BIM model with FreeCAD (using as reference the mesh or the IFC file from Blender).
Once you got a good mesh volume of the building geometry, export a stl file or IFC file to FreeCAD to recreate the main walls, windows, doors and aditional architecture details of the building with the [https://wiki.freecadweb.org/Arch_Module Arch Workbench]. at the end of this workflow the idea is to save a FreeCAD file with only 3D models. You can have a look to a FreeCAD file example [https://wiki.osarch.org/images/f/f2/Dormitorios01_02.FCStd here].

===== Importing the files to FreeCAD =====
# Opt 1) Import a mesh file.
#* If the result of the previous step was a simple mesh file, you can import with [https://wiki.freecadweb.org/Mesh_Workbench Mesh Design workbench].
#* Fix position and scale of the mesh with [https://wiki.freecadweb.org/Mesh_Scale Mesh Scale] tool.
# Opt 2) Import a IFC file.
#* If the result of the previous step was a IFC file, FreeCAD can import IFC2x3 or IFC4 based files. See [https://wiki.freecadweb.org/Arch_IFC Arch IFC]. 
#* Check the FreeCAD Preference for additional options of [https://wiki.freecadweb.org/Import_Export_Preferences IFC import/export] feature.

===== BIM modeling =====
# Based on the mesh/IFC, generate or complete the BIM model using the [https://wiki.freecadweb.org/Arch_Module Arch Workbench] or eventually, [https://wiki.freecadweb.org/BIM_Workbench BIM Workbench].
# For each building, place the 3D model components (walls, structures, and other arch elements) into an [https://wiki.freecadweb.org/Arch_BuildingPart Arch Building Part]. 
# For each Arch Building Part, create [https://wiki.freecadweb.org/Arch_SectionPlane Arch Section Planes] (for elevations, plans, sections, etc).
# For each Arch Section Planes, create [https://wiki.freecadweb.org/Draft_Shape2DView Draft Shape2DView] objects. You can edit the labels of these Shape2DView to refer view names.
#* Open [https://wiki.freecadweb.org/Draft_Module Draft Workbench]. 
#* Create all the Shape2DView projections, considering the necessary 2D views for the CAD documentation.
#* Arrange the Shape2DView projections in the 3D scene. Once you are done, you should not move these projections anymore.
# Save and close this file. This file will contain the 3D geometries and the plain Shape2DView projections for future references.


[[File:Freecad mesh.png|700px|none]]
[[File:FreeCAD BIM.png|700px|none]]
[[File:Freecad 3G2B1kQvK2.png|700px|none]]
[[File:Freecad BIM2.png|700px|none]]

== 2D CAD documentation ==

This step is for generating PDF files for printing, with 2D CAD documentation (sections, elevations, etc) with FreeCAD. The idea is to work with these 2D drawings in a new and independent FreeCAD file (independent from the 3D models file) that is very light and can be shared easily. The workflow involves the use of [https://wiki.freecadweb.org/Draft_Module Draft workbench] and [https://wiki.freecadweb.org/TechDraw_Module TechDraw workbench].

I share the 2D Freecad file as example of CAD documentation made with FreeCAD. You need FreeCAD +0.19 to open the file. Also, there is a bug with the TechDraw pages when you open the file (the drawing layout is a mess). Don't worry. Just click on Turn View Frames On/Off command in TechDraw Workbench and it will fix it. [https://community.osarch.org/uploads/editor/9w/0qj3m2zvdwbx.zip Link to the 2D FreeCAD file.]

===== 2D drawing with Draft workbench =====
# Create a new FC file.
# Import the Shape2DView objects from the FreeCAD file with the 3D models, using [https://wiki.freecadweb.org/Arch_Reference Arch Reference].
# As alternative, you can import the Shape2DView objects using [https://wiki.freecadweb.org/Std_LinkMake App:Link] option.
# Open [https://wiki.freecadweb.org/Draft_Module Draft workbench].
# Arrange the Shape2DView objects in the 3D space.
# Draw annotations, dimensions, symbols, lines, etc. with Draft workbench tools.
# Create a set of layers for Shape2DView objects, Dimensions, symbols, etc with [https://wiki.freecadweb.org/Draft_Layer Draft Layer].
# Place each group of 2D elements into the respective layer.
# Save the file.

[[File:Freecad JueqoDg3k8.png|700px|none]]

===== Page layout with TechDraw workbench =====
This workflow is just a suggestion. You can develop one for your own. But the purpose is to generate drawings with different line widths and styles, to enrich the sheet presentation. 

[https://wiki.freecadweb.org/TechDraw_Preferences TechDraw Preference] allows to setup many preferences and styles.

# Open [https://wiki.freecadweb.org/TechDraw_Module TechDraw workbench]
# Create a [https://wiki.freecadweb.org/TechDraw_PageDefault new TD Page] (define format and scale).
# Select a Shape2DView object or a group of them, from the Combo View panel.
# Press [https://wiki.freecadweb.org/TechDraw_View TechDraw Insert View] (TDIV) command to insert them in the TD page.
# Select Draft objects (lines, symbols), from the Combo View panel.
# Press TDIV command to insert them in the TD Page.
# On the TD page, place the TDIV of draft objects on top of the first TDIV.   
# With several TDIV for each group of objects, you can assign different properties (line width). 
#* Also, you can select specific lines of these TDIV and change their appearance with [https://wiki.freecadweb.org/TechDraw_DecorateLine TechDraw DecorativeLine].
# Select the Draft Layer of dimensions, in the Combo View panel. 
#* Press [https://wiki.freecadweb.org/TechDraw_DraftView TD Draft View] and setup its properties.  
#* Place on top of the rest of TDIV. 
# For lines with style, select their Draft Layer. Press TD DraftView and setup the properties:  
#* Data/ Line Style = 5,2,0,5,2 (or something similar, different numbers will produce different patterns). 
#* Data/ Override Style = true 
# Create a [https://wiki.freecadweb.org/TechDraw_ClipGroup TD ClipGroup] and place all the views inside. 
# You can create more TD pages if you want. If you need many pages, split the project in several FreeCAD files.

{| class="wikitable"
|+ Recommended links between TechDraw Views and 2D objects
|-
| use TD InsertView||for Shape2DView ||Plans, Sections||Allow to apply hatches on plans and sections areas.
|-
| use TD InsertView||for Draft lines||simple lines and symbols||Allow to work with different line widths.
|-
| use TD DraftView||for Draft Layers||Dimensions, Texts, lines||Allow to apply line styles and other properties on group of draft objects
|-
| use TD DraftView||for Draft objects||simple lines and symbols|| Allow to apply line styles and other properties on individual objects
|}

Here you can find more examples of [[Page layouts with TechDraw WB]].

===== Export PDF files =====
# Once the TD page is ready, you can move or share this FC file, and export PDF files of the drawing sheets.
#*Select the TD page to export. 
#*Press Menu File - Export PDF.


[[File:2DDrawingFC01.png|700px|none]]


[[File:2DDrawingFC02.png|700px|none]]


{{FreeCAD_Documentation}}
[[Category:FreeCAD]]