FreeCAD-Ship s60 tutorial: Difference between revisions

From FreeCAD Documentation
No edit summary
(30 intermediate revisions by 8 users not shown)
Line 1: Line 1:
<languages/>
In this tutorial we will work with Series 60 ship, from the Iowa University. The tutorial is aimed to show how to work with a symmetric monohull ship, but multihull or non symmetric ships can be performed with the same proceeding.
<translate>


<!--T:53-->
You can learn more about [[FreeCADShip_Workbench|FreeCAD-Ship here]]
{{TutorialInfo
|Topic=Ship Workbench
|Level=Beginner
|Time=
|Author=
|FCVersion=
|Files=
}}


== Introduction == <!--T:56-->
{{VeryImportantMessage|<center>'''Windows users'''</center>
<center>FreeCAD-Ship have been recently integrated into FreeCAD package, so some bugs can be detected.</center>
<center>If your Ship module have icons lost, please rename '''ShipIcons''' folder at</center>
<center>C:\Program Files (x86)\FreeCAD0.13\Mod\Ship</center>
<center>path as '''Icons''' folder, and then restart FreeCAD.</center>}}


<!--T:1-->
== Loading geometry ==
In this tutorial we will work with Series 60 ship, from the Iowa University. The tutorial is aimed to show how to work with a symmetric monohull ship, however multihull or non-symmetric ships can be performed with the same proceeding.


<!--T:2-->
=== Introduction ===
Learn more about [[Image:Workbench_Ship.svg|24px]] [[Ship Workbench|Ship Workbench]].


== Loading geometry == <!--T:3-->
FreeCAD-Ship works over '''Ship entities''', that must be created on top of provided geometry. Geometry must be a solid, or set of solids, following criteria must be taken into account:


=== Background === <!--T:4-->
The [[Image:Workbench_Ship.svg|24px]] [[Ship Workbench]] works over '''Ship entities''', that must be created on top of provided geometry. Geometry must be a solid (or set of solids), the following criteria must be taken into account:
* All hull geometry must be provided (including symmetric bodies).
* All hull geometry must be provided (including symmetric bodies).
* Starboard geometry must be included at negatives ''y'' domain.
* Starboard geometry must be included at negatives ''y'' domain.
* Origin (0,0,0) point is the '''Midship section''' (Midpoint between after and forward perpendicular) and '''base line''' intersection.
* Origin (0,0,0) point is the '''Midship section''' (Midpoint between after and forward perpendicular) and '''base line''' intersection.


<!--T:5-->
[[Image:FreeCAD-Ship-SignCriteria.jpg|center|Schematic view of sign criteria]]
[[Image:FreeCAD-Ship-SignCriteria.jpg|center|Schematic view of sign criteria]]
<center><span style="font-variant:small-caps">FreeCAD-Ship sign criteria</span></center>
<center><span style="font-variant:small-caps">FreeCAD-Ship sign criteria</span></center>


=== Loading Series 60 geometry ===
=== Loading Series 60 geometry === <!--T:6-->
In order to help new users the Ship workbench includes a geometries example loader, with the following to choose from:
* Series 60 from Iowa University
* Wigley Canonical Ship
* Series 60 Catamaran
* Wigley Catamaran


<!--T:7-->
In order to help new users FreeCAD-Ship includes an example geometries loader, with almost famous ship geometries.
[[Image:Ship_Load.svg|center|Example ship geometries loader icon.]]

<center><span style="font-variant:small-caps"> Ship Geometries Examples loader icon</span></center>
[[Image:FreeCAD-Ship-LoadIco.png|center|Example ship geometries loader icon.]]
<center><span style="font-variant:small-caps">Example ship geometries loader icon</span></center>


<!--T:8-->
Executing the tool (Ship design/Load an example ship geometry) a task dialogue will shown. Select '''Series 60 from Iowa University''' and press Accept. Tool loads new document with '''s60_IowaUniversity''' geometry.
Executing the tool (Ship design/Load an example ship geometry) a task dialogue will shown. Select '''Series 60 from Iowa University''' and press Accept. Tool loads new document with '''s60_IowaUniversity''' geometry.


<!--T:9-->
{{VeryImportantMessage|<center>'''Warning, before editing anything!'''</center>
{{VeryImportantMessage|'''Warning, before editing anything!'''
<center>You are now working with the original example file.</center>
You are now working with the original example file.
<center>To preserve the original unedited example, '''you must first save it as a new file, before editing anything.'''</center>}}
To preserve the original unedited example, '''you must first save it as a new file before editing anything.'''}}

== Create ship instance ==


== Create ship instance == <!--T:10-->
In order to create a '''Ship instance''' select s60 geometry and execute the '''ship creation tool''' (Ship design/Create a new ship).
In order to create a '''Ship instance''' select s60 geometry and execute the '''ship creation tool''' (Ship design/Create a new ship).


<!--T:11-->
[[Image:FreeCAD-Ship-Ico.png|center|Ship creation tool.]]
[[Image:Ship_Logo.svg|center|Ship creation tool.]]
<center><span style="font-variant:small-caps">Ship creation tool icon</span></center>
<center><span style="font-variant:small-caps">Ship creation tool icon</span></center>


<!--T:12-->
Creating ship task dialogue and some annotations at 3D view will shown. The annotations will removed when you close Ship creation tool, so don't worry about this.
Creating a Ship task dialogue and some annotations in the [[3D view]] will be shown. The annotations will disappear when you close the Ship creation tool, so don't worry about this.


<!--T:13-->
Most relevant ship data must be introduced (FreeCAD-Ship uses a progressive data introduction system, so basic operations can be performed knowing only basic ship data, more information is needed as the operations become more complex).
Most relevant ship data must be introduced (the [[Image:Workbench_Ship.svg|24px]] Ship workbench uses a progressive data introduction system, so basic operations can be performed knowing only basic ship data, more information is needed as the operations become more complex).

=== Ship data ===


=== Ship data === <!--T:14-->
Main dimensions must be introduced here:
Main dimensions must be introduced here:

* Length: Length between perpendiculars, 25.5 m for this ship.
* Length: Length between perpendiculars, 25.5 m for this ship.
* Beam: Total ship beam, 3.389 m for this ship.
* Beam: Total ship beam, 3.389 m for this ship.
* Draft: Design draft, 1.0 m for this ship.
* Draft: Design draft, 1.0 m for this ship.


<!--T:15-->
[[Image:FreeCAD-Ship-S60ShipCreationFront.png|center|Front view annotations]]
[[Image:FreeCAD-Ship-S60ShipCreationFront.png|center|Front view annotations]]
<center><span style="font-variant:small-caps">Length annotations.</span></center>
<center><span style="font-variant:small-caps">Length annotations.</span></center>


<!--T:16-->
Usually the Length between perpendiculars depends on design draft, so if you don't know what is the length of your ship you can set draft, and fit length in order to get bow and draft intersection.
Usually the Length between perpendiculars depends on design draft, so if you don't know what is the length of your ship you can set draft, and fit length in order to get bow and draft intersection.


<!--T:17-->
[[Image:FreeCAD-Ship-S60ShipCreationSide.png|center|Side view annotations]]
[[Image:FreeCAD-Ship-S60ShipCreationSide.png|center|Side view annotations]]
<center><span style="font-variant:small-caps">Beam annotations.</span></center>
<center><span style="font-variant:small-caps">Beam annotations.</span></center>


<!--T:18-->
Same process is valid for Beam fit. Note that requested value is total beam, but annotation is only refered to starboard half ship.
Same process is valid for Beam fit. Note that requested value is total beam, but annotation is only refered to starboard half ship.


<!--T:19-->
When you press '''Accept''' button program creates your new Ship instance called '''Ship''' at ''Tags & Attributes'' dialog. We don't need geometry anymore, so you can hide it.
When you press the {{Button|Accept}} button, a new Ship instance is created called '''Ship''' in the ''Tags & Attributes'' dialog. We don't need geometry anymore, so you can hide it.


<!--T:20-->
[[Image:FreeCAD-Ship-ShipInstance.png|center|Ship instance icon]]
[[Image:FreeCAD-Ship-ShipInstance.png|center|Ship instance icon]]
<center><span style="font-variant:small-caps">Ship instance icon.</span></center>
<center><span style="font-variant:small-caps">Ship instance icon.</span></center>


<!--T:21-->
From here onwards, you must have '''Ship''' selected before you execute any FreeCAD-Ship tool.
From here onward, you must have '''Ship''' selected before you execute any of the Ship Workbench tools.


== Outline draw ==
== Lines drawing == <!--T:22-->
The Ship workbench provides a tool that makes it easy to obtain a Lines Plan from the ship lines drawing


<!--T:23-->
FreeCAD-Ship provides a tool in order to make easy exporting ship outline draw.
[[Image:Ship_OutlineDraw.svg|center|Outline draw tool.]]
<center><span style="font-variant:small-caps">Lines drawing tool icon</span></center>


<!--T:24-->
[[Image:FreeCAD-Ship-OutlineDrawIco.png|center|Outline draw tool.]]
Lines drawing is a set of lines from section cuts in all 3 axis, that will eventually show the hull geometry in a Lines Plan. We need to provide the lines for the 3 following views:
<center><span style="font-variant:small-caps">Outline draw tool icon</span></center>
*Body Plan (using the Transversal Cuts)
*Sheer Plan (using the Longitudinals Cuts)
*Half-Breadth Plan (using the Waterlines Cuts)


Outline draw is a set of cuts that allows to meet the hull geometry with a standardized plot. Outline drawing needs the cuts set.


=== Transversal cuts ===
=== Transversal cuts === <!--T:25-->
Usually 21 transversal equidistant sections between perpendiculars must be performed. in order to do it FreeCAD provides an automatic tool in order to do it, simply select '''Transversal''' type of sections, go to '''Auto create''' box and set '''21''' sections, then press {{Button|Create sections}}

Usually 21 transversal equi-distance sections between perpendiculars must be performed. in order to do it FreeCAD provides an automatic tool in order to do it, simply select '''Transversal''' type of sections, go to '''Auto create''' box and set '''21''' sections, then press '''Create sections'''.


<!--T:26-->
[[Image:S60OutlineTransversal.png|center|Outline draw transversal sections preview.]]
[[Image:S60OutlineTransversal.png|center|Outline draw transversal sections preview.]]
<center><span style="font-variant:small-caps">Outline draw transversal sections preview</span></center>
<center><span style="font-variant:small-caps">Outline draw transversal sections preview</span></center>


<!--T:27-->
Sections table is filled, and sections preview called '''OutlineDraw''' shown. Ussually mor sections was added at bow and stern, where more complex curvatures are registered, in order to do it go to the end of the table, and do ''double click'' at empty item in order to edit it, pressing intro to confirm. Add following sections:
Sections table is filled and sections preview called '''OutlineDraw''' is shown. Usually more sections are added at bow and stern, where more complex curvatures are registered, to do this:

# Go to the end of the table and ''double click'' on an empty item in order to edit it.
* X<sub>22</sub> = -12.1125 m
# Press {{Button|intro}} to confirm.
* X<sub>23</sub> = 12.1125 m
# Add the following sections:

Depending hull geometry complexity, sections preview can take some time.

=== Longitudinal cuts ===


<!--T:28-->
Two longitudinal cuts must be added, so select '''Longitudinal''' type of sections, go to '''Auto create''' box and set '''2''' sections, then press '''Create sections'''. Sections table is filled, and sections preview updated.
:: X<sub>22</sub> = -12.1125 m
:: X<sub>23</sub> = 12.1125 m


<!--T:29-->
=== Water lines ===
Depending hull geometry complexity, sections preview can take some time. In order to remove a section, just fill it with an empty text and press enter.


=== Longitudinal cuts === <!--T:30-->
6 Water lines between base line and design draft must be added, so select '''Water lines''' type of sections, go to '''Auto create''' box and set '''5''' (Z = 0 m will not be considered, add it manually if you need it) sections, then press '''Create sections'''. Sections table is filled, and sections preview updated.
Two longitudinal cuts must be added, so select '''Longitudinal''' type of sections, go to '''Auto create''' box and set '''2''' sections, then press {{Button|Create sections}}. Sections table is filled, and sections preview updated.


=== Waterlines === <!--T:31-->
Several additional water lines must be added:
6 Waterlines between base line and design draft must be added, so select '''Waterlines''' type of sections, go to '''Auto create''' box and set '''5''' (Z = 0 m will not be considered, add it manually if you need it) sections, then press {{Button|Create sections}}. Sections table is filled, and sections preview updated.


<!--T:32-->
Several additional waterlines must be added:
* Z<sub>6</sub> = 1.2 m
* Z<sub>6</sub> = 1.2 m
* Z<sub>7</sub> = 1.4 m
* Z<sub>7</sub> = 1.4 m
Line 110: Line 142:
* Z<sub>10</sub> = 2.0 m
* Z<sub>10</sub> = 2.0 m


=== Perform plot ===
=== Perform plot === <!--T:33-->
Select '''1:100''' scale and press {{Button|Accept}} to let the tool to generate the 3D sections in a new object.


<!--T:34-->
Select '''1:100''' scale and press '''Accept'''. Plot is performed, you can learn more about plotting and how to edit it [[Drawing_Workbench|here]] (Depending on version, projected version of plot can be bad represented, or not represented).
[[Image:FreeCAD-Ship-S60Outline3DSections.png|center|Resultant sections.]]
<center><span style="font-variant:small-caps">Resultant sections.</span></center>

<!--T:35-->
In order to plot these sections you can use the [[Drawing_Workbench|Drawing workbench]]:


<!--T:36-->
[[Image:FreeCAD-Ship-S60OutlinePlot.png|center|Outline draw plot.]]
[[Image:FreeCAD-Ship-S60OutlinePlot.png|center|Outline draw plot.]]
<center><span style="font-variant:small-caps">Outline draw plot.</span></center>
<center><span style="font-variant:small-caps">Outline draw plot.</span></center>


== Transversal areas curve == <!--T:37-->
3D sections are preserved to in order you can work with them (i.e.- Multisolid ships may have undesired edges at plot).
One typical ship design hydrodynamic parameter is the transversal areas curve, that retrieves some indicators about the behaviour of the hull (towing resistance, seakeeping, ...). The Ship workbench provides a simple tool in order to perform transversal areas curve.

[[Image:FreeCAD-Ship-S60Outline3DSections.png|center|Resultant sections.]]
<center><span style="font-variant:small-caps">Resultant sections.</span></center>

== Transversal areas curve ==

One typical ship design hydrodynamic parameter is the transversal areas curve, that retrieves some indicators about the behaviour of the hull (towing resistance, seakeeping, ...). FreeCAD-Ship provides a simple tool in order to perform transversal areas curve.


<!--T:38-->
[[Image:FreeCAD-Ship-AreaCurveIco.png|center|Transversal areas curve tool icon.]]
[[Image:FreeCAD-Ship-AreaCurveIco.png|center|Transversal areas curve tool icon.]]
<center><span style="font-variant:small-caps">Transversal areas curve tool icon.</span></center>
<center><span style="font-variant:small-caps">Transversal areas curve tool icon.</span></center>


<!--T:39-->
When tool is executed a task dialog is shown, and free surface prewied is created at 3D view (Free surface preview will be removed when tool finished, so don't worry about them). Into task dialog input and output data is present.
When tool is executed a task dialog is shown, and free surface preview is created in the [[3D view]] (Free surface preview will be removed when tool finished, so don't worry about this). Into task dialog input and output data is present.

=== Input data ===


=== Input data === <!--T:40-->
Draft and trim (Hull ''y edge'' rotation angle, positive if stern draft may increase) must be provided. Several areas curves may be performed, depending on ship load situations, but two typical plot should be performed:
Draft and trim (Hull ''y edge'' rotation angle, positive if stern draft may increase) must be provided. Several areas curves may be performed, depending on ship load situations, but two typical plot should be performed:
* Design transversal areas curve: Without trimming angle and using design draft, 1.0 m in this case.
* Maximum draft transversal areas curve: Without trimming angle, and maximum draft allowed, 2.0 m in this case.


=== Output data === <!--T:41-->
* Design transversal areas curve: Without triming angle and using design draft, 1.0 m in this case.
* Maximum draft transversal areas curve: Without trimin angle, and maximum draft allowed, 2.0 m in this case.

=== Output data ===

Some relevant data is shown at real time:
Some relevant data is shown at real time:
* '''L''': Length between perpendiculars, value set at ship instance creation.

* '''L''': Lenght between perpendiculars, value set at ship instance creation.
* '''B''': Beam selected at ship creation.
* '''B''': Beam selected at ship creation.
* '''T''': Actual draft amidships.
* '''T''': Actual draft amidships.
Line 151: Line 182:
* '''XCB''': Buoyancy centre point X coordinate (relative to midship section).
* '''XCB''': Buoyancy centre point X coordinate (relative to midship section).


<!--T:42-->
When '''Accept''' button is pressed a plot is performed (depending on geometry complexity can take some time, you can see progress on terminal, and stop work pressing '''Ctrl+C''').
When {{Button|Accept}} button is pressed a plot is performed (depending on geometry complexity can take some time, you can see progress on terminal, and stop the work pressing {{KEY|Ctrl}}+{{KEY|C}}). When the task has finished FreeCAD will generate a Plot (see the [[Plot_Workbench|Plot workbench]] documentation) and a SpreadSheet (see the [[Spreadsheet_Workbench|Spreadsheet workbench]] documentation).

You need to have pyxplot installed on your computer. As it is a big dependency it is not a default option.


<!--T:43-->
[[Image:FreeCAD-Ship-s60Areas.png|center|Design draft transversal areas curve. ]]
[[Image:FreeCAD-Ship-s60Areas.png|center|800px|Design draft transversal areas curve. ]]
<center><span style="font-variant:small-caps">Design draft transversal areas curve. </span></center>
<center><span style="font-variant:small-caps">Design draft transversal areas curve. </span></center>


<!--T:44-->
You can perform maximum draft transversal areas curve in order to see the differences (for instance areas curve pass through length perpendiculars).
You can perform maximum draft transversal areas curve in order to see the differences (for instance you are noticing that areas curve is passing through length perpendiculars now).

FreeCAD-Ship use [http://www.pyxplot.org.uk/ pyxplot] in order to generate plot as '''*.eps''' image, and [http://www.ghostscript.com/ ghostscript] in order to convert it to '''*.png''' image. You can see where '''areas.dat''' output file has been placed at the report view (View/Views/Report view), and load it with datasheet software (for example [http://www.libreoffice.org libreOffice]). Nearby data file several auxiliary files has been created too:

* '''areas.dat''': Contains transversal areas data.
* '''areas.pyxplot''': pyxplot layout in order to plot '''areas.dat''' sheet.
* '''areas.eps''': EPS image version (best choice in order to edit it).
* '''areas.png''': Final image PNG version.

When new transversal areas curve is performed files will be overwritten, so copy it at other place if you want to preserve it.

== Hydrostatics ==


== Hydrostatics == <!--T:45-->
Hydrostatics computation is a critical stage at ship design due to know principal stability hull parameters. Hydrostatics are mandatory data in order to classification societies certificates ship, and joined with loading condition data (weights and gravity position) provides essential data about ship stability. FreeCAD-Ship provides a tool to obtain main hydrostatics curves (GZ curves are considered in other tool).
Hydrostatics computation is a critical stage at ship design due to know principal stability hull parameters. Hydrostatics are mandatory data in order to classification societies certificates ship, and joined with loading condition data (weights and gravity position) provides essential data about ship stability. FreeCAD-Ship provides a tool to obtain main hydrostatics curves (GZ curves are considered in other tool).


<!--T:46-->
[[Image:FreeCAD-Ship-HydrostaticsIco.png‎|center|Hydrostatics tool icon.]]
[[Image:FreeCAD-Ship-HydrostaticsIco.png‎|center|Hydrostatics tool icon.]]
<center><span style="font-variant:small-caps">Hydrostatics tool icon.</span></center>
<center><span style="font-variant:small-caps">Hydrostatics tool icon.</span></center>


<!--T:47-->
When tool is executed a task dialog is shown. Ussually Hydrostatics curves are presented for each trim angle, in this tutorial only upright trimming angle will considered (0º), with an interval around every loading condition draft. Since we don't know what loading conditions we can get, we will consider almost draft posibilities (Ussually, in order to get as many resolution as possible, naval architecs fits the interval to feasible drafts).
When tool is executed a task dialog is shown. Usually Hydrostatics curves are presented for each trim angle, in this tutorial only upright trimming angle will considered (0º), with an interval around every loading condition draft. Since we don't know what loading conditions we can get, we will consider almost draft possibilities (Usually, in order to get as many resolution as possible, naval architects fits the interval to feasible drafts).


<!--T:48-->
So we set following data:
So we set following data:
* '''Trim''' = 0º
* '''Trim''' = 0 deg
* '''Minimum Draft''' = 0.1 m
* '''Minimum Draft''' = 0.1 m
* '''Maximum Draft''' = 2.0 m
* '''Maximum Draft''' = 2.0 m
* '''Number of points''' = 39. A lot of points or really complex geometries imply long computation times, in this case around 1 minute can be expent.
* '''Number of points''' = 39. A lot of points or really complex geometries imply long computation times, in this case around 1 minute can be expend.

When '''Accept''' button is pressed plots are performed.

[[Image:FreeCAD-Ship-HydrostaticsCurves.jpg|center|Hydrostatics curves. ]]
<center><span style="font-variant:small-caps">Hydrostatics curves. </span></center>

As transversal areas curve tool, Hydrostatics tools use [http://www.pyxplot.org.uk/ pyxplot] in order to generate plots as '''*.eps''' image, and [http://www.ghostscript.com/ ghostscript] in order to convert to '''*.png''' images. You can see where '''hydrostatics.dat''' output file has been placed at the report view (View/Views/Report view), and load it with datasheet software (for example [http://www.libreoffice.org libreOffice]). Nearby data file several auxiliary files has been created too:


<!--T:49-->
* '''hydrostatics.dat''': Computed hydrostatics data.
When '''Accept''' button is pressed plots are performed (see the [[Plot_Workbench|Plot workbench]] documentation) and a spreadsheet is generated (see the [[Spreadsheet_Workbench|Spreadsheet workbench]] documentation).
* '''volume.pyxplot''': pyxplot layout in order to plot the curves.
* '''volume.eps''': EPS image version of volume related Hydrostatics.
* '''volume.png''': Final volume related hydrostatics PNG version.
* '''stability.eps''': EPS image version of stability related Hydrostatics.
* '''stability.png''': Final stability related hydrostatics PNG version.
* '''coeffs.eps''': EPS image version of forms coeffcients related Hydrostatics.
* '''coeffs.png''': Final forms coeffcients related hydrostatics PNG version.


<!--T:50-->
All files will overwritten when new hydrostatics are computed, so save them before repeat the process.
[[Image:FreeCAD-Ship-HydrostaticsCurves.png|800px|center|Hydrostatics curves.]]
<center><span style="font-variant:small-caps">Hydrostatics curves.</span></center>


== Continue learning FreeCAD-Ship ==
== Continue learning == <!--T:51-->


<!--T:57-->
Now you are ready to continue learning [[FreeCADShip_Workbench|FreeCAD-Ship]], [[FreeCAD-Ship_s60_tutorial_(II)|here]] is the second chapter of Series 60 from Iowa university ship.
The [[FreeCAD-Ship_s60_tutorial_(II)|FreeCAD Ship s60 tutorial (II)]] is the second chapter of Series 60 from Iowa university ship.


[[Category:Tutorials]]


</translate>
{{languages | {{es|FreeCAD-Ship_s60_tutorial/es}} {{fr|FreeCAD-Ship_s60_tutorial/fr}}}}
[[Category:Ship{{#translation:}}]]

Revision as of 11:18, 24 April 2022

Tutorial
Topic
Ship Workbench
Level
Beginner
Time to complete
Authors
FreeCAD version
Example files
See also
None

Introduction

In this tutorial we will work with Series 60 ship, from the Iowa University. The tutorial is aimed to show how to work with a symmetric monohull ship, however multihull or non-symmetric ships can be performed with the same proceeding.

Learn more about Ship Workbench.

Loading geometry

Background

The Ship Workbench works over Ship entities, that must be created on top of provided geometry. Geometry must be a solid (or set of solids), the following criteria must be taken into account:

  • All hull geometry must be provided (including symmetric bodies).
  • Starboard geometry must be included at negatives y domain.
  • Origin (0,0,0) point is the Midship section (Midpoint between after and forward perpendicular) and base line intersection.
Schematic view of sign criteria
Schematic view of sign criteria
FreeCAD-Ship sign criteria

Loading Series 60 geometry

In order to help new users the Ship workbench includes a geometries example loader, with the following to choose from:

  • Series 60 from Iowa University
  • Wigley Canonical Ship
  • Series 60 Catamaran
  • Wigley Catamaran
Example ship geometries loader icon.
Example ship geometries loader icon.
Ship Geometries Examples loader icon

Executing the tool (Ship design/Load an example ship geometry) a task dialogue will shown. Select Series 60 from Iowa University and press Accept. Tool loads new document with s60_IowaUniversity geometry.

Warning, before editing anything!

You are now working with the original example file.

To preserve the original unedited example, you must first save it as a new file before editing anything.

Create ship instance

In order to create a Ship instance select s60 geometry and execute the ship creation tool (Ship design/Create a new ship).

Ship creation tool.
Ship creation tool.
Ship creation tool icon

Creating a Ship task dialogue and some annotations in the 3D view will be shown. The annotations will disappear when you close the Ship creation tool, so don't worry about this.

Most relevant ship data must be introduced (the Ship workbench uses a progressive data introduction system, so basic operations can be performed knowing only basic ship data, more information is needed as the operations become more complex).

Ship data

Main dimensions must be introduced here:

  • Length: Length between perpendiculars, 25.5 m for this ship.
  • Beam: Total ship beam, 3.389 m for this ship.
  • Draft: Design draft, 1.0 m for this ship.
Front view annotations
Front view annotations
Length annotations.

Usually the Length between perpendiculars depends on design draft, so if you don't know what is the length of your ship you can set draft, and fit length in order to get bow and draft intersection.

Side view annotations
Side view annotations
Beam annotations.

Same process is valid for Beam fit. Note that requested value is total beam, but annotation is only refered to starboard half ship.

When you press the Accept button, a new Ship instance is created called Ship in the Tags & Attributes dialog. We don't need geometry anymore, so you can hide it.

Ship instance icon
Ship instance icon
Ship instance icon.

From here onward, you must have Ship selected before you execute any of the Ship Workbench tools.

Lines drawing

The Ship workbench provides a tool that makes it easy to obtain a Lines Plan from the ship lines drawing

Outline draw tool.
Outline draw tool.
Lines drawing tool icon

Lines drawing is a set of lines from section cuts in all 3 axis, that will eventually show the hull geometry in a Lines Plan. We need to provide the lines for the 3 following views:

  • Body Plan (using the Transversal Cuts)
  • Sheer Plan (using the Longitudinals Cuts)
  • Half-Breadth Plan (using the Waterlines Cuts)


Transversal cuts

Usually 21 transversal equidistant sections between perpendiculars must be performed. in order to do it FreeCAD provides an automatic tool in order to do it, simply select Transversal type of sections, go to Auto create box and set 21 sections, then press Create sections

Outline draw transversal sections preview.
Outline draw transversal sections preview.
Outline draw transversal sections preview

Sections table is filled and sections preview called OutlineDraw is shown. Usually more sections are added at bow and stern, where more complex curvatures are registered, to do this:

  1. Go to the end of the table and double click on an empty item in order to edit it.
  2. Press intro to confirm.
  3. Add the following sections:
X22 = -12.1125 m
X23 = 12.1125 m

Depending hull geometry complexity, sections preview can take some time. In order to remove a section, just fill it with an empty text and press enter.

Longitudinal cuts

Two longitudinal cuts must be added, so select Longitudinal type of sections, go to Auto create box and set 2 sections, then press Create sections. Sections table is filled, and sections preview updated.

Waterlines

6 Waterlines between base line and design draft must be added, so select Waterlines type of sections, go to Auto create box and set 5 (Z = 0 m will not be considered, add it manually if you need it) sections, then press Create sections. Sections table is filled, and sections preview updated.

Several additional waterlines must be added:

  • Z6 = 1.2 m
  • Z7 = 1.4 m
  • Z8 = 1.6 m
  • Z9 = 1.8 m
  • Z10 = 2.0 m

Perform plot

Select 1:100 scale and press Accept to let the tool to generate the 3D sections in a new object.

Resultant sections.
Resultant sections.
Resultant sections.

In order to plot these sections you can use the Drawing workbench:

Outline draw plot.
Outline draw plot.
Outline draw plot.

Transversal areas curve

One typical ship design hydrodynamic parameter is the transversal areas curve, that retrieves some indicators about the behaviour of the hull (towing resistance, seakeeping, ...). The Ship workbench provides a simple tool in order to perform transversal areas curve.

Transversal areas curve tool icon.
Transversal areas curve tool icon.
Transversal areas curve tool icon.

When tool is executed a task dialog is shown, and free surface preview is created in the 3D view (Free surface preview will be removed when tool finished, so don't worry about this). Into task dialog input and output data is present.

Input data

Draft and trim (Hull y edge rotation angle, positive if stern draft may increase) must be provided. Several areas curves may be performed, depending on ship load situations, but two typical plot should be performed:

  • Design transversal areas curve: Without trimming angle and using design draft, 1.0 m in this case.
  • Maximum draft transversal areas curve: Without trimming angle, and maximum draft allowed, 2.0 m in this case.

Output data

Some relevant data is shown at real time:

  • L: Length between perpendiculars, value set at ship instance creation.
  • B: Beam selected at ship creation.
  • T: Actual draft amidships.
  • Trim: Trim angle.
  • TAP: After perpendicular draft.
  • TFP: Forward perpendicular draft.
  • Displacement: Ship displacement (salt water considered, divide by 1.025 in order to know displaced volume).
  • XCB: Buoyancy centre point X coordinate (relative to midship section).

When Accept button is pressed a plot is performed (depending on geometry complexity can take some time, you can see progress on terminal, and stop the work pressing Ctrl+C). When the task has finished FreeCAD will generate a Plot (see the Plot workbench documentation) and a SpreadSheet (see the Spreadsheet workbench documentation).

Design draft transversal areas curve.
Design draft transversal areas curve.
Design draft transversal areas curve.

You can perform maximum draft transversal areas curve in order to see the differences (for instance you are noticing that areas curve is passing through length perpendiculars now).

Hydrostatics

Hydrostatics computation is a critical stage at ship design due to know principal stability hull parameters. Hydrostatics are mandatory data in order to classification societies certificates ship, and joined with loading condition data (weights and gravity position) provides essential data about ship stability. FreeCAD-Ship provides a tool to obtain main hydrostatics curves (GZ curves are considered in other tool).

Hydrostatics tool icon.
Hydrostatics tool icon.
Hydrostatics tool icon.

When tool is executed a task dialog is shown. Usually Hydrostatics curves are presented for each trim angle, in this tutorial only upright trimming angle will considered (0º), with an interval around every loading condition draft. Since we don't know what loading conditions we can get, we will consider almost draft possibilities (Usually, in order to get as many resolution as possible, naval architects fits the interval to feasible drafts).

So we set following data:

  • Trim = 0 deg
  • Minimum Draft = 0.1 m
  • Maximum Draft = 2.0 m
  • Number of points = 39. A lot of points or really complex geometries imply long computation times, in this case around 1 minute can be expend.

When Accept button is pressed plots are performed (see the Plot workbench documentation) and a spreadsheet is generated (see the Spreadsheet workbench documentation).

Hydrostatics curves.
Hydrostatics curves.
Hydrostatics curves.

Continue learning

The FreeCAD Ship s60 tutorial (II) is the second chapter of Series 60 from Iowa university ship.