- Discovering FreeCAD
- Installing
- The FreeCAD interface
- Navigating in the 3D view
- Working with FreeCAD
- Preparing models for 3D printing
- Using spreadsheets
- Python scripting
- A gentle introduction
FreeCAD equips you with all the right tools for your needs. You get modern Finite Element Analysis (FEA) tools, experimental CFD, dedicated BIM, Geodata or CAM/CNC workbenches, a robot simulation module that allows you to study robot movements and many more features. FreeCAD really is a Swiss Army knife of general-purpose engineering toolkits. FreeCAD is an open source CAD/CAE tool based on OpenCASCADE. FreeCAD has tools similar to CATIA, SolidWorks or Solid Edge, so it will also provide CAX (CAD, CAM, CAE), PLM and other functions. This will be a software architecture based on parametric modeling functions and modularity, which makes it easy to provide additional functions without modifying the core.
Python is a popular, open source programming language, very often embedded in applications as a scripting language, as is the case with FreeCAD. It has a series of features that make it suitable for us FreeCAD users: It is very easy to learn, especially for people who had never programmed before, and it is embedded in many other applications. This make it a valuable tool to learn, as you will be able to use it in other software, such as Blender, Inkscape or GRASS.
FreeCAD makes extensive use of Python. With it, you can access and control almost any feature of FreeCAD. For example, you can create new objects, modify their geometry, analyze their contents, or even create new interface controls, tools and panels. Some FreeCAD workbenches and most of the addon workbenches are fully programmed in Python. FreeCAD has an advanced Python console, available from menu View->Panels->Python console. It is often useful to perform operations for which there is no toolbar button yet, or to check shapes for problems, or to perform repetitive tasks:
But the Python console has another very important use: Every time you press a toolbar button, or perform other operations in FreeCAD, some Python code is printed in the console and executed. By leaving the Python console open, you can literally see the Python code unfold as you work, and in no time, almost without knowing it, you will learning some of the Python language.
FreeCAD also has a macros system, which allows you to record actions to be replayed later. This system also uses the Python console, by simply recording everything that is done in it.
In this chapter, we will discover very generally the Python language. If you are interested in learning more, the FreeCAD documentation wiki has an extensive section related to Python programming.
Writing Python code
There are two easy ways to write Python code in FreeCAD: From the Python console (menu View -> Panels -> Python Console), or from the Macro editor (menu Tools -> Macros -> New). In the console, you write Python commands one by one, which are executed when you press return, while the macros can contain a more complex script made of several lines, which is executed only when the macro is launched from the same Macros window.
In this chapter, you will be able to use both methods, but it is highly recommended to use the Python Console, since it will immediately inform you of any errors you make while typing.
If this is your first time using Python, consider reading this short introduction to Python programming before going any further, it will make the basic concepts of Python clearer.
Manipulating FreeCAD objects
Let's start by creating a new empty document:
If you type this in the FreeCAD Python console, you will notice that as soon as you type 'FreeCAD.' (the word FreeCAD followed by a dot), a windows pops up, allowing to quickly autocomplete the rest of your line. Even better, each entry in the autocomplete list has a tooltip explaining what it does. This makes it very easy to explore the functionality available. Before choosing 'newDocument', have a look at the other options available.
As soon as you press Enter our new document will be created. This is similar to pressing the 'new document' button on the toolbar. In Python, the dot is used to indicate something that is contained inside something else (newDocument is a function that is inside the FreeCAD module). The window that pops up therefore shows you everything that is contained inside 'FreeCAD'. If you would add a dot after newDocument, instead of the parentheses, it would show you everything that is contained inside the newDocument function. The parentheses are mandatory when you are calling a Python function, such as this one. We will illustrate that better below.
Now let's get back to our document. Let's see what we can do with it. Type the following and explore the available options:
Usually names that begin with an upper-case letter are attributes: they contain a value. Names that begin with a lower-case letter are functions (also called methods): they 'do something'. Names that begin with an underscore are usually there for the internal use of the module, and you should ignore them. Let's use one of the methods to add a new object to our document:
Our box is added in the tree view, but nothing happens in the 3D view yet, because when working from Python, the document is never recomputed automatically. We must do that manually, whenever required:
Now our box has appeared in the 3D view. Many of the toolbar buttons that add objects in FreeCAD actually do two things: add the object, and recompute. If you turned on the 'show script commands in Python console' option above, try now adding a sphere with the appropriate button in the Part Workbench, and you will see the two lines of Python code being executed one after the other.
Freecad Manual Pdf Download
You can get a list of all possible object types like Part::Box:
Now let's explore the contents of our box:
You'll immediately see a couple of very interesting things such as:
This will print the current height of our box. Now let's try to change that:
If you select your box with the mouse, you will see that in the properties panel, under the Data tab, our Height property appears with the new value. All properties of a FreeCAD object that appear in the Data and View tabs are directly accessible by Python too, by their names, like we did with the Height property. Data properties are accessed directly from the object itself, for example:
View properties are stored inside a ViewObject. Each FreeCAD object possesses a ViewObject, which stores the visual properties of the object. When running FreeCAD without its Graphical Interface (for example when launching it from a terminal with the -c command line option, or using it from another Python script), the ViewObject is not available, since there is no visual at all.
Try the following example to access the line color of our box:
Vectors and Placements
Vectors are a fundamental concept in any 3D application. It is a list of 3 numbers (x, y and z), describing a point or position in the 3D space. A lot of things can be done with vectors, such as additions, subtractions, projections and much more. In FreeCAD vectors work like this:
Another common feature of FreeCAD objects is their Placement. As we saw in earlier chapters, each object has a Placement property, which contains the position (Base) and orientation (Rotation) of the object. These properties are easy to manipulate from Python, for example to move our object:
Read more
Power user documentation- FreeCAD scripting:Python, Introduction to Python, Python scripting tutorial, FreeCAD Scripting Basics
- Modules:Builtin modules, Units, Quantity
- Workbenches:Workbench creation, Gui Commands, Commands, Installing more workbenches
- Meshes and Parts:Mesh Scripting, Topological data scripting, Mesh to Part, PythonOCC
- Parametric objects:Scripted objects, Viewproviders(Custom icon in tree view)
- Scenegraph:Coin (Inventor) scenegraph, Pivy
- Graphical interface:Interface creation, Interface creation with UI files, Interface creation completely in Python(1, 2, 3, 4, 5), PySide, PySide examples beginner, intermediate, advanced
- Macros:Macros, How to install macros
- Embedding:Embedding FreeCAD, Embedding FreeCADGui
- Other:Expressions, Code snippets, Line drawing function, FreeCAD vector math library(deprecated)
- Hubs:User hub, Power users hub, Developer hub
Important Note: The manual has been moved to the official FreeCAD wiki which is now its new home. If you wish to propose edits, please do them there, as this repository will be kept only for generating the ebook versions and will not be directly edited anymore.
Introduction
Freecad Manual Download
FreeCAD is a free, open-source parametric 3D modeling application. It is made primarily to model real-world objects, ranging from the small electronic components up to buildings and civil engineering projects, with a strong focus on 3D-printable objects. FreeCAD is free to download, use, distribute and modify, and its source code is open and published under the very permissive LGPL license. The data you produce with FreeCAD is fully yours, and can be recovered without FreeCAD.
FreeCAD is also fundamentally a social project, as it is developed and maintained by a community of developers and users united by their passion for FreeCAD.
This manual is an experiment at taking the opposite way from the official FreeCAD documentation wiki. The wiki is written collaboratively by dozens of community members and, like most wikis, it contains huge amounts of information, but is very hard to access and navigate by newcomers. This makes it a precious resource for reference, but not a very practical tool to learn FreeCAD. This manual will walk you through the same information available on the wiki. However, we hope that the more step-by-step pace, based on examples, and the more unified tone given by a smaller number of authors, will make it more suitable for a first contact with FreeCAD, and that it will become a perfect companion for the wiki.
This manual has been originally written for the stable version of FreeCAD at that time, which was version 0.16. It is now in the process of being updated to the upcoming 0.19.
PDF, EPUB and MOBI versions of the original editions can be found in the Releases section. You can also read it directly from github pages
All the contents of this manual are published under the Creative Commons 4.0 license, and can be freely used, downloaded, copied, and modified. The source files of this manual are hosted on github. At this address, you can also find and download all the files that have been created during the different exercises that are part of this book.
Freecad Manual Pdf
About the author(s)
This book has been written originally by Yorik van Havre, (and corrected, proof-read or updated by many other people) but using a lot of information built by FreeCAD users, mostly from the FreeCAD wiki. The real author of this book is actually the whole FreeCAD community!