Is "Basic Part Design Tutorial" in line with actual Part Design workflow?

Discussions about the wiki documentation of FreeCAD and its translation.
Forum rules
Be nice to others! Respect the FreeCAD code of conduct!
User avatar
Roy_043
Veteran
Posts: 8450
Joined: Thu Dec 27, 2018 12:28 pm

Re: Is "Basic Part Design Tutorial" in line with actual Part Design workflow?

Post by Roy_043 »

This is on my todo list. I'll try to have a look later this week.
User avatar
onekk
Veteran
Posts: 6146
Joined: Sat Jan 17, 2015 7:48 am
Contact:

Re: Is "Basic Part Design Tutorial" in line with actual Part Design workflow?

Post by onekk »

Roy_043 wrote: Mon Nov 07, 2022 4:52 pm This is on my todo list. I'll try to have a look later this week.
Thanks, I will review a little the code, for sure there are some errors, yesterday I've tried to avoid some images using a schematic with "named points", mimicking the GUI appearance (with standard theme).

I will pospone every other edits after I ear some new for you, so there is not too much noise.

My residual problem is to add the produced file, adding pd_tut_xxxx.FCStd and pd_tut_xxxx.fcstd will raise an error, there is a special procedure?

Regards

Carlo D.
GitHub page: https://github.com/onekk/freecad-doc.
- In deep articles on FreeCAD.
- Learning how to model with scripting.
- Various other stuffs.

Blog: https://okkmkblog.wordpress.com/
edwilliams16
Veteran
Posts: 3108
Joined: Thu Sep 24, 2020 10:31 pm
Location: Hawaii
Contact:

Re: Is "Basic Part Design Tutorial" in line with actual Part Design workflow?

Post by edwilliams16 »

Here's a few thoughts. I was reluctant to directly edit your draft.
  • Shrink the drawing
  • In create the first sketch, explain about two escapes and the option to right click here rather than later. I remember being frustrated by this when learning.
  • The symmetrical constraint centers the top edge about the origin (not just the Y-axis). This allows us to take advantage of the model's symmetry in later mirror operations.
  • Sketch002 is on the XZ-plane.
  • We could also use the Base YZ plane as the symmetry plane - which may be easier to visualize.
  • Sketch003 is on the XY-plane
  • Show a figure for Sketch003 e.g.
Screen Shot 2022-11-09 at 8.41.08 AM.png
Screen Shot 2022-11-09 at 8.41.08 AM.png (17.49 KiB) Viewed 1359 times
  • In Sketch004 for P3/P4 a vertical constraint could replace either of the point-on-line constraints. Using all three would be redundant.
  • Pocket001 - here use 17mm symmetric to plane. The length/length2 option would be useful were it not symmetric - which might be good to note anyway.
User avatar
onekk
Veteran
Posts: 6146
Joined: Sat Jan 17, 2015 7:48 am
Contact:

Re: Is "Basic Part Design Tutorial" in line with actual Part Design workflow?

Post by onekk »

edwilliams16 wrote: Wed Nov 09, 2022 7:09 pm Here's a few thoughts. I was reluctant to directly edit your draft.
Hello, first of all many thanks, for the review and for tutoring me.

I have tried to implement some of your suggestions, and modified the page.

Sorry I don't guess completely all points, due for sure to my poor knowledge of both Sketcher and English. :D

I will try to be puncutal, see below:
Shrink the drawing
Done
In create the first sketch, explain about two escapes and the option to right click here rather than later. I remember being frustrated by this when learning.
Done, but some text revision is needed, as the original text is referring to the polyline tool, due to "low knowledge" of Sketcher I don't know if we could generalize the sentence for other tools too. Could you please suggest what is the best way to explain this thing, I have copied the notes and joined in one place.

Probably we should name it in some meaningful manner, (I added Caveats) and/or add some other notes.
The symmetrical constraint centers the top edge about the origin (not just the Y-axis). This allows us to take advantage of the model's symmetry in later mirror operations.
Yes this make sense, I have to modify some drawings, noted down for now.
Sketch002 is on the XZ-plane.
Done
We could also use the Base YZ plane as the symmetry plane - which may be easier to visualize.
Some proposal for the image?
Sketch003 is on the XY-plane
Done
Show a figure for Sketch003 e.g.
Where?
In Sketch004 for P3/P4 a vertical constraint could replace either of the point-on-line constraints. Using all three would be redundant.
I could not get the point here, could you kindly explain me more extensively ?
Pocket001 - here use 17mm symmetric to plane. The length/length2 option would be useful were it not symmetric - which might be good to note anyway.
Proposed change?


Many Thanks and Regards

Carlo D.
GitHub page: https://github.com/onekk/freecad-doc.
- In deep articles on FreeCAD.
- Learning how to model with scripting.
- Various other stuffs.

Blog: https://okkmkblog.wordpress.com/
User avatar
Shalmeneser
Veteran
Posts: 9475
Joined: Wed Dec 23, 2020 12:04 am
Location: Fr

Re: Is "Basic Part Design Tutorial" in line with actual Part Design workflow?

Post by Shalmeneser »

... part shown in the Drawing below. -> https://wiki.freecadweb.org/Glossary#Drawing ?

If you had checked Auto constraints in Edit controls window in sketcher

Select XY_Plane in from the Combo view list. Press OK
or
Select XY_Plane from the 3D view. No need to press OK (except in v0.19).

Don't place points on X axis as the Solver will ...

Once done press ESC or Right-click to exit ...

Symmetrical constraint -> I prefer to put P2 and P3 on X-axis then set them symmetrical around Y-axis

Select line defined by P2 to P3 in Fig: SKC1. -> Select one horizontal line ...
Select line defined by P3 to P4 in Fig: SKC1 -> Select one vertical line ...

How to leave master sketch ?

___
for the moment

Code: Select all

OS: Linux Mint 20.3 (MATE/mate)
Word size of OS: 64-bit
Word size of FreeCAD: 64-bit
Version: 0.19.24276 (Git) AppImage
Build type: Release
Branch: (HEAD detached at 0.19.1)
Hash: a88db11e0a908f6e38f92bfc5187b13ebe470438
Python version: 3.8.8
Qt version: 5.12.9
Coin version: 4.0.0
OCC version: 7.4.0
Locale: French/France (fr_FR)


User avatar
onekk
Veteran
Posts: 6146
Joined: Sat Jan 17, 2015 7:48 am
Contact:

Re: Is "Basic Part Design Tutorial" in line with actual Part Design workflow?

Post by onekk »

Shalmeneser wrote: Sat Nov 12, 2022 2:02 pm ...
Thanks I will work on it probably tomorrow.

EDIT: @edwilliams16 has done most of these corrections. (Thanks Ed) :D

Regards

Carlo D.
GitHub page: https://github.com/onekk/freecad-doc.
- In deep articles on FreeCAD.
- Learning how to model with scripting.
- Various other stuffs.

Blog: https://okkmkblog.wordpress.com/
User avatar
onekk
Veteran
Posts: 6146
Joined: Sat Jan 17, 2015 7:48 am
Contact:

Re: Is "Basic Part Design Tutorial" in line with actual Part Design workflow?

Post by onekk »

I have some doubts:
  1. As noted by @edwilliams16 for Sketch003 an image of the sketch should be added, better to do using points, so there is no ambiguity and maybe refer to the point of Sketch003, reference to P1 on image SK2_2 seems almost clear.
  2. I have modified the page explicitly using Stepxx instead of numbers, as nested list will make things more involuted, it seems more clear (I know that we are not newbies, but I think the main scope of the tutorial is to guide a newbie through the points, without repeating explanations too much).
  3. How to ad the file to show the result, I've had error messages when I,ve tried with FCStd and fcstd extensions, bu no luck.
I have had one reply from an user that have found it decent, maybe wait for other remarks.

It should be almost decent to ask for a proper link in the Tutorial page?

Regards

Carlo D.
GitHub page: https://github.com/onekk/freecad-doc.
- In deep articles on FreeCAD.
- Learning how to model with scripting.
- Various other stuffs.

Blog: https://okkmkblog.wordpress.com/
User avatar
Roy_043
Veteran
Posts: 8450
Joined: Thu Dec 27, 2018 12:28 pm

Re: Is "Basic Part Design Tutorial" in line with actual Part Design workflow?

Post by Roy_043 »

You cannot upload an FCStd file to the Wiki.

You can attach it to a forum post:
Basic_Sketcher_Tutorial

Or do a PR to have it added to https://github.com/FreeCAD/Examples:
Basic_Part_Design_Tutorial
Last edited by Roy_043 on Sun Nov 13, 2022 6:33 pm, edited 1 time in total.
User avatar
Roy_043
Veteran
Posts: 8450
Joined: Thu Dec 27, 2018 12:28 pm

Re: Is "Basic Part Design Tutorial" in line with actual Part Design workflow?

Post by Roy_043 »

onekk wrote: Sun Nov 13, 2022 11:10 am a proper link in the Tutorial page?
Don't worry, that will be added in due course.
User avatar
onekk
Veteran
Posts: 6146
Joined: Sat Jan 17, 2015 7:48 am
Contact:

Re: Is "Basic Part Design Tutorial" in line with actual Part Design workflow?

Post by onekk »

Roy_043 wrote: Sun Nov 13, 2022 6:33 pm
onekk wrote: Sun Nov 13, 2022 11:10 am a proper link in the Tutorial page?
Don't worry, that will be added in due course.
Thanks I will try to make a PR, but in the GitHub site there is an optional way saying to ask on a forum post, but link seems not working.

Regards

Carlo D.
GitHub page: https://github.com/onekk/freecad-doc.
- In deep articles on FreeCAD.
- Learning how to model with scripting.
- Various other stuffs.

Blog: https://okkmkblog.wordpress.com/
Post Reply