FreeCAD Managing Expectations: Difference between revisions

From FreeCAD Documentation
("dashed" list -> bulleted list)
No edit summary
 
(42 intermediate revisions by 2 users not shown)
Line 2: Line 2:
<translate>
<translate>


<!--T:68-->
{{VeryImportantMessage|'' While we welcome and encourage community growth and participation, demands, emotional rants and wild claims are generally poorly received as our community is made up of many experienced and passionate supporters of FreeCAD who have heard similar statements many times over. If you find a feature lacking, or something which is an annoying bug for you, we highly encourage you to consider getting engaged with the code itself. FreeCAD is largely developed by a relatively small group of talented people who all have day jobs, families and other interests beyond just programming on-demand. If you have the skills (Python/C++) and motivation to participate, your contributions can help make FreeCAD even better than it is today. You can find tracked bugs/feature requests [https://github.com/FreeCAD/FreeCAD/issues here]. ''}}
{{VeryImportantMessage|While we welcome and encourage community growth and participation, demands, emotional rants and wild claims are generally poorly received as our community is made up of many experienced and passionate supporters of FreeCAD who have heard similar statements many times over. If you find a feature lacking, or something which is annoying for you, we highly encourage you to consider getting engaged with the code itself. FreeCAD is largely developed by a relatively small group of talented people who all have day jobs, families and other interests beyond just programming on-demand. If you have the skills (Python/C++) and motivation to participate, your contributions can help make FreeCAD even better than it is today. You can find tracked bugs/feature requests [https://github.com/FreeCAD/FreeCAD/issues here].}}


</translate>
</translate>
Line 13: Line 14:
This wiki page is intended for new FreeCAD users coming from other CAD/CAM solutions.
This wiki page is intended for new FreeCAD users coming from other CAD/CAM solutions.


== Opening Statement == <!--T:39-->
== Opening statement == <!--T:69-->


<!--T:70-->
Many hobbyists, freelance designers and small businesses often seek refuge from the high costs and licensing restrictions of commercial software, or perhaps you merely chose FreeCAD because you believe in the philosophy behind [https://en.wikipedia.org/wiki/FOSS FOSS]. In either case, WELCOME! There are many users, just like you who have successfully made the transition to FreeCAD for their personal and professional needs. This wiki page is designed to help set you on the path of success and establish some realistic expectations while diving into the ''FreeCAD Way'', which is most likely quite a bit different than what you may have grown accustomed to with other popular CAD software.
Many hobbyists, freelance designers and small businesses often seek refuge from the high costs and licensing restrictions of commercial software, or perhaps you merely choose FreeCAD because you believe in the philosophy behind [https://en.wikipedia.org/wiki/FOSS FOSS]. In either case, WELCOME! There are many users, just like you who have successfully made the transition to FreeCAD for their personal and professional needs. This wiki page is designed to help set you on the path to success and establish some realistic expectations while diving into the ''FreeCAD Way'', which is most likely quite a bit different from what you may have grown accustomed to with other popular CAD software.


== What can I expect? == <!--T:43-->
== What can I expect? == <!--T:43-->


<!--T:44-->
<!--T:44-->
At its core, FreeCAD is a powerful parametric modeler. It uses a modular 'workbench' concept, where each workbench is responsible for specific tasks and functions. This construct is extremely powerful and can be successfully used for many purposes. FreeCAD is actively developed, used in production, and quite stable; but like any other CAD program, it is not 100% stable.
At its core, FreeCAD is a powerful parametric modeler. It uses a modular 'workbench' concept, where each workbench is responsible for specific tasks and functions. This concept is very flexible and can be successfully used for many purposes. FreeCAD is actively developed, used in production, and quite stable; but like any other CAD program, it is not 100% stable.


<!--T:45-->
<!--T:45-->
Coming from another CAD program you may find FreeCAD's terminology, structure and organization to be slightly foreign. You can also expect to make adjustments to your workflows, learn functional workarounds or utilize our powerful [https://wiki.freecadweb.org/Macros macro] ecosystem, but in most cases you will be able to achieve what you want. And if you need help: we have a very active and responsive [https://forum.freecad.org/index.php forum] willing to assist. Among the forum members there are bound to be (former) users of your current CAD program. So do not hesitate to tap into that resource.
Coming from another CAD program you may find FreeCAD's terminology, structure and organization to be slightly foreign. You will probably need to make some adjustments to your workflows, learn functional workarounds or utilize our powerful [[Macros|macro]] ecosystem, but in most cases you will be able to achieve what you want. And if you need help: we have a very active and responsive [https://forum.freecad.org/index.php forum] willing to assist. Among the forum members there are bound to be (former) users of your current CAD program. So do not hesitate to tap into that resource.


== How can I contribute? == <!--T:49-->
== How can I contribute? == <!--T:49-->
Line 30: Line 32:
There are many ways: you can make a [[Donate|donation]], help with [https://forum.freecad.org/index.php forum] questions, or write documentation or code. See [[Help_FreeCAD|Help FreeCAD]].
There are many ways: you can make a [[Donate|donation]], help with [https://forum.freecad.org/index.php forum] questions, or write documentation or code. See [[Help_FreeCAD|Help FreeCAD]].


== Learning Resources ==
== Learning resources == <!--T:71-->


=== Official ===
=== Official === <!--T:72-->


<!--T:73-->
[https://wiki.freecadweb.org This Wiki]<br>
* [[Main_Page|This Wiki]]
[https://forum.freecadweb.org/viewforum.php?f=3 The Help Forum]<br>
[https://wiki.freecadweb.org/Workarounds Work-arounds for known problems]<br>
* [https://forum.freecadweb.org/viewforum.php?f=3 The Help Forum]
* [[Workarounds|Workarounds for known problems]]


=== Un-Official ===
=== Un-official === <!--T:74-->


<!--T:75-->
The following YouTube Channels have reasonably good quality content focused around FreeCAD<br>
The following YouTube Channels have reasonably good quality content focused around FreeCAD (it is recommended to ignore any tutorials based on version 0.17 or earlier):
''MangoJelly Solutions'' (several beginner, intermediate and advanced video playlists)<br>
''Joko EngineeringHelp'' (intermediate/advanced videos)<br>
* ''MangoJelly Solutions'' (several beginner, intermediate and advanced video playlists)
* ''Joko EngineeringHelp'' (intermediate/advanced videos)
''Brodie Fairhall'' (A couple of videos helping Fusion 360 users transition to FreeCAD)<br>
* ''Brodie Fairhall'' (A couple of videos helping Fusion 360 users transition to FreeCAD)
and more... it is recommended to ignore any tutorials not based on version 0.18 or newer.
* And more...


== Questions and Answers ==
== Questions and answers == <!--T:76-->


=== "Can FreeCAD do XYZ?" ===
=== "Can FreeCAD do XYZ?" === <!--T:77-->


<!--T:78-->
FreeCAD already has the ability to do the following type of work:
FreeCAD already has the ability to do the following types of work:
* Spline-based parametric modeling using the [https://wiki.freecadweb.org/Part_Workbench Part], [https://wiki.freecadweb.org/PartDesign_Workbench Part Design] and [https://wiki.freecadweb.org/Sketcher_Workbench Sketcher] workbenches
* Spline-based parametric modeling using the [[Part_Workbench|Part]], [[PartDesign_Workbench|Part Design]] and [[Sketcher_Workbench|Sketcher]] workbenches
* [https://wiki.freecadweb.org/Surface_Workbench Surface]/[https://wiki.freecadweb.org/Curves_Workbench Curves] modeling using NURBS
* [[Surface_Workbench|Surface]]/[[Curves_Workbench|Curves]] modeling using NURBS
* [https://wiki.freecadweb.org/Mesh_Workbench Mesh] import/modifications
* [[Mesh_Workbench|Mesh]] import/modifications
* Assembly simulation (3 different approaches, [https://wiki.freecadweb.org/A2plus_Workbench A2+], [https://wiki.freecadweb.org/Assembly3_Workbench ASM3], and [https://wiki.freecadweb.org/Assembly4_Workbench ASM4] are all actively developed)
* Assembly simulation (3 different approaches, [[A2plus_Workbench|A2+]], [[Assembly3_Workbench|ASM3]], and [[Assembly4_Workbench|ASM4]], are all actively developed)
* [https://wiki.freecadweb.org/Arch_Workbench Architectural/BIM design]
* [[Arch_Workbench|Architectural]]/[[BIM_Workbench|BIM]] design
* Mechanical Stress Analysis (https://wiki.freecadweb.org/FEM_Workbench FEM/FEA])
* Mechanical Stress Analysis ([[FEM_Workbench|FEM/FEA]])
* Computational Fluid Dynamic Analysis [https://wiki.freecadweb.org/Cfd_Workbench (CFD)]
* Computational Fluid Dynamic Analysis ([[Cfd_Workbench|CFD]])
* [https://wiki.freecadweb.org/TechDraw_Workbench Technical Drawings] / [https://wiki.freecadweb.org/Draft_Workbench Drafting]
* [[TechDraw_Workbench|Technical Drawings]]/[[Draft_Workbench|Drafting]]
* and more [https://wiki.freecadweb.org/Workbenches core] and [https://wiki.freecadweb.org/External_workbenches external] workbenches...
* And more [[Workbenches|core]] and [[External_workbenches|external]] workbenches...


=== "User Interface (UI/UX) is ugly, odd, confusing or not like XYZ Software!" ===
=== "User interface (UI/UX) is ugly, odd, confusing or not like XYZ Software!" === <!--T:79-->


<!--T:80-->
FreeCAD allows for [https://wiki.freecadweb.org/Interface_Customization extensive customization] of the user interface, while we realize the default colors or arrangement of elements may not be pleasing to everyone, we encourage you to tailor it to your own specific needs and work-flows. If you feel you've come up with what could be a popular arrangement/theme/customized toolbars etc. please feel free to look into leveraging the recently added [https://wiki.freecadweb.org/Preference_Packs/en "Preference Pack"] feature and share it with the community. Perhaps your efforts will help ease someone less experienced/patient in their transition into FreeCAD. FOSS software thrives on all sorts of community contributions and this is a common topic of discussion.
FreeCAD allows for [[Interface_Customization|extensive customization]] of the user interface. While we realize the default colors or arrangement of elements may not be pleasing to everyone, we encourage you to tailor it to your own specific needs and work-flows. If you feel you've come up with what could be a popular arrangement/theme/customized toolbars etc. please feel free to look into leveraging the recently added [[Preference_Packs|Preference Pack]] feature and share it with the community. Perhaps your efforts will help someone else in their transition to FreeCAD. FOSS software thrives on all sorts of community contributions and this is a common topic of discussion.


=== "Why doesn't this feature work like in XYZ software?" ===
=== "Why doesn't this feature work like in XYZ software?" === <!--T:81-->


<!--T:82-->
FreeCAD has a development pedigree spanning over [https://wiki.freecadweb.org/History 20 years of development]. Functions and behaviors are heavily reviewed, debated and assessed before they are added or changed. Have an open mind, while it may not be apparent, there is likely a very good rationale behind such things. This isn't to say that FreeCAD is perfect, but please consider that what you've grown used to may not be the only or best way to get something done.
FreeCAD has a development pedigree spanning over [[History|20 years]]. Functions and behaviors are heavily reviewed, debated and assessed before they are added or changed. Have an open mind, while it may not be apparent, there is likely a very good rationale behind such things. This isn't to say that FreeCAD is perfect, but please consider that what you've grown used to may not be the only or best way to get something done.


=== "I can't figure out the workflow of FreeCAD!" ===
=== "I can't figure out the workflow of FreeCAD!" === <!--T:83-->


<!--T:84-->
FreeCAD has a philosophy to not dictate 'how' you use it. Rather it provides tools and a wide array of options under which you 'can' use them. This means two things. First, the software isn't going to necessarily 'guide' or 'steer' you in a certain style of workflow. Second, this means you can experiment with the tools and find what works best for you. This doesn't mean there aren't general [https://wiki.freecadweb.org/Feature_editing 'best practices'] to keep in mind while using FreeCAD, but those best practices generally apply to ANY professional design software when creating stable models.
FreeCAD has a philosophy to not dictate 'how' you use it. Rather it provides tools and a wide array of options under which you 'can' use them. This means two things. First, the software isn't going to necessarily 'guide' or 'steer' you toward a certain style or workflow. Second, this means you can experiment with the tools and find what works best for you. This doesn't mean there aren't general [[Feature_editing|'best practices']] to keep in mind while using FreeCAD, but those best practices generally apply to any professional design software when creating stable models.


=== "What the heck is with all these workbenches?" ===
=== "What the heck is with all these workbenches?" === <!--T:85-->


<!--T:86-->
One of the powerful features of FreeCAD is it's modularity. This is done by compartmentalizing tool development into workbenches. Once you are familiar with the tools provided they can often work synergistically to create highly complex and advanced models. A great analogy is that FreeCAD is structured similar to a mechanics rolling tool-chest, and each workbench is a drawer of specific tools. You can use these tools to build a car, but it is up to the mechanic to understand how to use them to accomplish their goal.
One of the powerful features of FreeCAD is it's modularity. This is done by compartmentalizing tool development into workbenches. Once you are familiar with the tools provided they can often work synergistically to create highly complex and advanced models. A great analogy is that FreeCAD is structured similar to a mechanics rolling tool-chest, and each workbench is a drawer of specific tools. You can use these tools to build a car, but it is up to the mechanic to understand how to use them to accomplish their goal.


=== "FreeCAD is fundamentally broken, my models blow-up!" ===
=== "FreeCAD is fundamentally broken, my models blow-up!" === <!--T:87-->


<!--T:88-->
FreeCAD is build around an open-source Geometric Modeling Kernel called "Open CASCADE Technology" (or OCCT). It is the most feature rich and mature open source modeling kernel available. However it does have bugs, quirks and limitations. One of these is referred to as the [https://wiki.freecadweb.org/Topological_naming_problem "Topological Naming Problem"] (or TNP). What happens whenever a model is changed, the internal names of faces or edges get renamed by the kernel and any model features which referenced them causes undesirable behavior. The current development cycle is focused around implementing a naming algorithm which is designed to mitigate this effect under most circumstances. However, be aware that TNP mitigation is not a replacement for [https://wiki.freecadweb.org/Feature_editing good modeling practice and techniques].
FreeCAD is built around an open-source Geometric Modeling Kernel called "[[OpenCASCADE|OpenCascade Technology]]" (or OCC). It is the most feature rich and mature open source modeling kernel available. However it does have bugs, quirks and limitations. One of these is referred to as the [[Topological_naming_problem|"Topological Naming Problem"]] (or TNP). Whenever a model is modified, the internal names of faces and edges are changed by the kernel causing undesirable behavior for any model features that reference them. The current development cycle is focused around implementing a naming algorithm designed to mitigate this effect under most circumstances. However, be aware that TNP mitigation is not a replacement for [[Feature_editing|good modeling practice and techniques]].


== OpenCascade Kernel ==
== OpenCascade kernel == <!--T:63-->


<!--T:64-->
OpenCascade (OCC/OCCT) is a core external CAD kernel dependency that FreeCAD is utterly dependent on. There are many open 'upstream' bugs that the FreeCAD community has identified and track regarding OCC. We track them via the:
OpenCascade (OCC) is an external CAD kernel that FreeCAD is utterly dependent on. There are many open 'upstream' bugs that the FreeCAD community has identified and tracks regarding OCC. See:
* [https://github.com/FreeCAD/FreeCAD/issues?q=is%3Aopen+is%3Aissue+label%3A%223rd+Party%3A+OCC%22 bugtracker]
* [https://forum.freecad.org/viewtopic.php?t=20264 forum thread] called ''OCC Bugs in the Bugtracker''
* [https://github.com/FreeCAD/FreeCAD/issues?q=is%3Aopen+is%3Aissue+label%3A%223rd+Party%3A+OCC%22 Bugtracker]
* [https://forum.freecad.org/viewtopic.php?t=20264 OCC Bugs in the Bugtracker (forum thread)]


== Additional Links ==
== Additional links == <!--T:66-->


<!--T:67-->
* [https://forum.freecadweb.org/viewtopic.php?f=8&t=43461 Discussion: FreeCAD is not ready for 1.0 (forum thread)]
* [https://forum.freecadweb.org/viewtopic.php?f=8&t=43461 Discussion: FreeCAD is not ready for 1.0 (forum thread)]
* [https://www.youtube.com/watch?v=JBmdbipkbrk Why the GIMP Team Obviously* Hates You (*We Actually Love You. **Mostly)] Pat David from GIMP team presentation at SCaLE16x California 2016
* [https://www.youtube.com/watch?v=JBmdbipkbrk Why the GIMP Team Obviously* Hates You (*We Actually Love You. **Mostly)] Pat David from GIMP team presentation at SCaLE16x California 2016

Latest revision as of 20:16, 13 July 2022

Other languages:
While we welcome and encourage community growth and participation, demands, emotional rants and wild claims are generally poorly received as our community is made up of many experienced and passionate supporters of FreeCAD who have heard similar statements many times over. If you find a feature lacking, or something which is annoying for you, we highly encourage you to consider getting engaged with the code itself. FreeCAD is largely developed by a relatively small group of talented people who all have day jobs, families and other interests beyond just programming on-demand. If you have the skills (Python/C++) and motivation to participate, your contributions can help make FreeCAD even better than it is today. You can find tracked bugs/feature requests here.

Purpose

This wiki page is intended for new FreeCAD users coming from other CAD/CAM solutions.

Opening statement

Many hobbyists, freelance designers and small businesses often seek refuge from the high costs and licensing restrictions of commercial software, or perhaps you merely choose FreeCAD because you believe in the philosophy behind FOSS. In either case, WELCOME! There are many users, just like you who have successfully made the transition to FreeCAD for their personal and professional needs. This wiki page is designed to help set you on the path to success and establish some realistic expectations while diving into the FreeCAD Way, which is most likely quite a bit different from what you may have grown accustomed to with other popular CAD software.

What can I expect?

At its core, FreeCAD is a powerful parametric modeler. It uses a modular 'workbench' concept, where each workbench is responsible for specific tasks and functions. This concept is very flexible and can be successfully used for many purposes. FreeCAD is actively developed, used in production, and quite stable; but like any other CAD program, it is not 100% stable.

Coming from another CAD program you may find FreeCAD's terminology, structure and organization to be slightly foreign. You will probably need to make some adjustments to your workflows, learn functional workarounds or utilize our powerful macro ecosystem, but in most cases you will be able to achieve what you want. And if you need help: we have a very active and responsive forum willing to assist. Among the forum members there are bound to be (former) users of your current CAD program. So do not hesitate to tap into that resource.

How can I contribute?

There are many ways: you can make a donation, help with forum questions, or write documentation or code. See Help FreeCAD.

Learning resources

Official

Un-official

The following YouTube Channels have reasonably good quality content focused around FreeCAD (it is recommended to ignore any tutorials based on version 0.17 or earlier):

  • MangoJelly Solutions (several beginner, intermediate and advanced video playlists)
  • Joko EngineeringHelp (intermediate/advanced videos)
  • Brodie Fairhall (A couple of videos helping Fusion 360 users transition to FreeCAD)
  • And more...

Questions and answers

"Can FreeCAD do XYZ?"

FreeCAD already has the ability to do the following types of work:

"User interface (UI/UX) is ugly, odd, confusing or not like XYZ Software!"

FreeCAD allows for extensive customization of the user interface. While we realize the default colors or arrangement of elements may not be pleasing to everyone, we encourage you to tailor it to your own specific needs and work-flows. If you feel you've come up with what could be a popular arrangement/theme/customized toolbars etc. please feel free to look into leveraging the recently added Preference Pack feature and share it with the community. Perhaps your efforts will help someone else in their transition to FreeCAD. FOSS software thrives on all sorts of community contributions and this is a common topic of discussion.

"Why doesn't this feature work like in XYZ software?"

FreeCAD has a development pedigree spanning over 20 years. Functions and behaviors are heavily reviewed, debated and assessed before they are added or changed. Have an open mind, while it may not be apparent, there is likely a very good rationale behind such things. This isn't to say that FreeCAD is perfect, but please consider that what you've grown used to may not be the only or best way to get something done.

"I can't figure out the workflow of FreeCAD!"

FreeCAD has a philosophy to not dictate 'how' you use it. Rather it provides tools and a wide array of options under which you 'can' use them. This means two things. First, the software isn't going to necessarily 'guide' or 'steer' you toward a certain style or workflow. Second, this means you can experiment with the tools and find what works best for you. This doesn't mean there aren't general 'best practices' to keep in mind while using FreeCAD, but those best practices generally apply to any professional design software when creating stable models.

"What the heck is with all these workbenches?"

One of the powerful features of FreeCAD is it's modularity. This is done by compartmentalizing tool development into workbenches. Once you are familiar with the tools provided they can often work synergistically to create highly complex and advanced models. A great analogy is that FreeCAD is structured similar to a mechanics rolling tool-chest, and each workbench is a drawer of specific tools. You can use these tools to build a car, but it is up to the mechanic to understand how to use them to accomplish their goal.

"FreeCAD is fundamentally broken, my models blow-up!"

FreeCAD is built around an open-source Geometric Modeling Kernel called "OpenCascade Technology" (or OCC). It is the most feature rich and mature open source modeling kernel available. However it does have bugs, quirks and limitations. One of these is referred to as the "Topological Naming Problem" (or TNP). Whenever a model is modified, the internal names of faces and edges are changed by the kernel causing undesirable behavior for any model features that reference them. The current development cycle is focused around implementing a naming algorithm designed to mitigate this effect under most circumstances. However, be aware that TNP mitigation is not a replacement for good modeling practice and techniques.

OpenCascade kernel

OpenCascade (OCC) is an external CAD kernel that FreeCAD is utterly dependent on. There are many open 'upstream' bugs that the FreeCAD community has identified and tracks regarding OCC. See:

Additional links