FreeCAD's python Importer & Exporter for GDML files.
Install by use of FreeCAD Addon Manager
Needs lxml which should be installed as part of FreeCAD
- FreeCAD_0.19.19424 and above.
- FreeCAD_0.19.19409_x64_Conda_Py3QT5-WinVS2015.7z and above.
If you get an error message No module named 'lxml' then on Linux you can diagnose as follows.
To check path FreeCAD uses from a command line.
freecad -c
import sys
print(sys.path)
To check lxml correctly installed for freecad
freecad -c
import lxml
from lxml import etree
print(etree.LXML_VERSION)
On linux to install lxml to a specific directory
pip3 install lxml -t <directory>
For more information on GDML see
GDML Solids are implemented as FreeCAD Python Objects and have the same properties as defined by GDML. By selecting an Object the properties can be changed via the FreeCAD properties windows and the resulting changes displayed.
- Start FreeCAD
- Select the GDML workbench from the workbench dropdown menu.
- Select File > New
Result: This will load the default GDML File with materials and creates a World Volume. - Create
1-n Volumes
in the World Volume by- Click on the Part icon (image: yellow blockish icon)
- Drag the created Part to the World Volume in the Tree window
- Part maybe renamed via right click context menu
- Create GDML Solids by:
- Clicking on the corresponding icon of the workbench.
- Drag the GDML object to the appropriate Part again via the Tree window
- You can then change the attributes by selecting the GDMLObject in the Tree window then changing the properties in the Property View
So a valid structure for a GDML file is:
- Single World Volume (Part)
- A number of Volumes (Parts) under the World Volume
- A number of GDML Objects can exist in one Part ( GDML Logical Volume)
- To Export to GDML
- Select the 'World' Volume ( Default Name WorldVol )
- File export
- Select filetype as GDML ( Bottom Box of Export file window)
- Select Destination and file name with GDML as file extension
Important Notes:
- Opening a new file when the GDML workbench is active will load a Default file.
- The Default file is defined in
GDML/Mod/Resources/Default.gdml
. - New GDML objects have the material set to
SSteel0x56070ee87d10
i.e. the first material in the Default file. - Other materials can be set by editing the material property via the FreeCAD parameters View of the Object after creation.
Upon switching to the GDML workbench, one will notice a number of icons that become available on the Workbench bar.
- Clicking on one the icons will create a GDML object with default values.
- It should then be dragged to the appropriate Part (GDML Logical Volume)
- In neccessary, once can then edit the properties via the properties window. The parameters should be the same as in the GDML user guide.
- If the Object is part of a Boolean you will have to use the recompute facility of FreeCAD to see the change to the Boolean. This can be achieved through the right clicking on the context menu or clicking the Recompute icon in the toolbar.
On import or open of a GDML file a Dialog box will open with two options
- Import
- Scan Vol
Import will do a straight import of GDML Objects etc.
Scan Vol is for large files like Alice.GDML that take far too long to process.
Volumes are only processed to a limit depth i.e. volume names are determined but not processed
For unprocessed volume the names are preceded by NOT_Expanded
so an example volume name would be: NOT_Expanded_<VolumeName>
Unexpanded Volumes can be expanded by:
- Switching to the GDML workbench.
- Selecting a volume in the labels & attributes window
- Clicking on the experimental Expand Volume icon 'E'
On opening of a GDML file the appropriate FreeCAD implemented python Object is created for each solid
The first icon on the workbench bar is different. If you select a object by one of the following methods
-
A volume via the Combo view - Model - Labels & Attributes.
Then click on the icon it will cycle the display mode of the selected Volume and all its children. The cycle is Solid -> WireFrame -> Not Displayed -> Solid
-
In the main display - select a face by
Then click on the icon it will cycle the display mode of the selected object
SampleFiles directory contains some sample gdml files.
One in particular is lhcbvelo.gdml. This file takes a LONG LONG time to import/open, over a minute on my system, but does eventually load. On my system I have to okay one wait. When it finally does display you will want to zoom in.
If when it is displayed you go down the Volumes tree to VelovVelo under the World volume then click on the toggle icon ( 1st GDML icon in the workbench) Again wait patiently and the display will change to wireframe. You can then decend further down the Volumes tree, select one and again use the toggle icon and that volume and children will change to Solid. In this way various parts in different volumes can be examined.
To export to GDML
- Select the 'world' Volume, should be first Part in Design
- File export
- Select GDML as filetype
- Make sure file has GDML as file extension
GDMLObjects are output as straight GDML solids
The following FreeCAD objects are output as GDML equivalents
FreeCAD | GDML |
---|---|
Cube | Box |
Cone | Cone |
Cylinder | Tube |
Sphere | Sphere |
If not handled as above then objects shapes are checked to see if planar, if yes converts to Tessellated Solid with 3 or 4 vertex as appropriate. If not creates a mesh and then a Tessellated solid with 3 vertex.
Importing a GDML will create FreeCAD objects for the above and export should create the same GDML definitions as imported.
The Ability to change to change these maybe implemented in the future.
There is now an option to toggle Printverbose
flag to reduce printing to the python console.
-
Select a volume/Part i.e. the first Part which is the GDML world volume and click on the
compound
icon 'C'- Create an object named Compound under the selected Volume
- Create an FEM Analysis Object.
- All the materials of the objects in the Volume/Part/Compound are added to the Analysis Object.
-
You can then switch to the FEM Workbench (Finite Element Analysis) and proceed with an analysis which would include:
- Double click on each of the materials to edit their properties
- From the FEM workbench select the Compound Object and click on the icon to create a Mesh.
- Rest would depend on what analysis and what solver it is intended to use.
Also as an experiment: thermal parameters have been added to the
GDMLmaterial
object so these could be changed before creating a compound. One option to be would be to add elements to GDML files to enable loading and exporting, but then they would NOT be standard GDML files (maybe a different file extension?)
In directory Utils You will find a python script gdml2step.py for creating a step file from a gdml file.
syntax is
python3 gdml2step.py <input gdml file> <output step file>
The step file should be given a .step extension.
In theory other file extension should produce a file of the appropriate type,
e.g. iges, but this is untested.
- Change structure of xml handing to use Python class rather than global variables
- Check handling of different Positioning between GDML & FreeCAD
- Add support for quantity
- Add further GDML Objects
- Add facility to edit Materials
- Add facility to edit Isotopes
- Add facility to edit Elements
- Documentation
- Investigate handling of Materials
- Need to sort out AIR definition
Workbench
- Workbench Dialog for initial GDML Object values(?)
- Analyze FreeCAD file for direct conversion of object to GDML solid
- Display mesh for objects that will not directly convert
- Provide options to control meshing objects that will be Tessellated
- Icons to Analize and Export
Note: For NIST Materials database see http://physics.nist.gov/PhysRefData
based on gdml.xsd
-
'Volumes'
- Must have solid & material ref
-
PhysVol
- Must contain volref ( or file )
- volref must not be same as current volume name
- May contain position or position ref
- May contain rotation or rotation ref
Graphic Icons
- GDML Shapes designed by Jim Austin (jmaustpc)
- Cycle icon by Flaticon see www.flaticon.com
Thank you also to:
-
Louis Helary
-
Emmanuel Delage
-
Wouter Deconnick
-
Hilden Timo
-
FreeCAD forum members (Applogies if I left anybody off ) :
- wmayer
- Joel_graff
- chrisb
- DeepSOIC
- ickby
- looooo
- easyw-fc
- bernd
- vocx
- sgrogan
- onekk (Carlo D)
-
OpenCascade Forum members:
- Sergey Slyadnev
-
Workbench Dialog for initial GDML Object values(?)
-
Handle different Positioning between GDML & FreeCAD
-
Add support for quantity
-
Add further GDML Objects
-
Add facility to add Volume
-
Add facility to edit Materials
-
Add facility to edit Isotopes
-
Add facility to edit Elements
-
Workbench
- Analize FreeCAD file for direct conversion of object to GDML solid
- Display mesh for objects that will not directly convert
- Provide options to control meshing objects that will be Tessellated
- Icons to Analize and Export
-
Tidy softLink script
-
Make FreeCAD an installable workbench
-
Documentation
-
Investigate handling of Materials
For NIST Materials database see http://physics.nist.gov/PhysRefData
Please report bugs by opening a ticket in the FreeCAD_Python_GDML issue queue
Note: I am always on the look out for test gdml files (small to medium size)XXXX# FreeCAD_Python_GDML
To contact the author via email: keith[at]sloan-home[dot]co[dot]uk