Skip to content

Commit 958cb8f

Browse files
committed
Refactoring
1 parent dcbeeea commit 958cb8f

16 files changed

Lines changed: 454 additions & 62 deletions

content/_index.md

Lines changed: 10 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -37,6 +37,16 @@ layout: hextra-home
3737
imageClass="hx-top-[40%] hx-left-[24px] hx-w-[180%] sm:hx-w-[110%] dark:hx-opacity-80"
3838
style="background: radial-gradient(ellipse at 50% 80%,rgba(194,97,254,0.15),hsla(0,0%,100%,0));"
3939
>}}
40+
41+
{{< hextra/feature-card
42+
title="Wave Scatter Diagram Tool"
43+
subtitle="The Wave Scatter Diagram Tool generates **global wave scatter diagrams** in accordance with **DNVGL-RP-C205**. It uses the DNV-recommended Conditional Modelling Approach (CMA) to estimate sea state occurrence for different navigational zones, supports Weibull and Log-Normal distributions for HS and TZ(**Nautic zones**, **North Atlantic** and **World Wide trade**), allows user-defined bin settings, and enables export of data and figures for direct use in reports."
44+
link="/wave_scatter_diagram"
45+
class="hx-aspect-auto md:hx-aspect-[1.1/1] max-md:hx-min-h-[340px]"
46+
image="./images/Snipaste_2026-01-27_10-06-43.png"
47+
imageClass="hx-top-[40%] hx-left-[24px] hx-w-[180%] sm:hx-w-[110%] dark:hx-opacity-80"
48+
style="background: radial-gradient(ellipse at 50% 80%,rgba(194,97,254,0.15),hsla(0,0%,100%,0));"
49+
>}}
4050
4151
{{< hextra/feature-card
4252
title="HydroModeller"

content/dp_capability_tool/tutorials/tutorial1/_index.md

Lines changed: 187 additions & 58 deletions
Original file line numberDiff line numberDiff line change
@@ -6,80 +6,209 @@ sidebar:
66
open: true
77
---
88

9-
Hextra supports creating site with multiple languages using Hugo's [multilingual mode](https://gohugo.io/content-management/multilingual/).
9+
# Tutorial: DP Capability Analysis for an Offshore Wind Turbine Installation Vessel
1010

11-
<!--more-->
11+
## 1. Introduction
1212

13-
## Enable Multi-language
13+
This tutorial demonstrates how to use the **DP Capability Tool** to perform **feasibility calculation** and **capability analyses** for an offshore wind turbine installation vessel equipped with:
1414

15-
To make our site multi-language, we need to tell Hugo the supported languages. We need to add to the site configuration file:
15+
- **2 azimuth thrusters at the bow**
16+
- **3 tunnel thrusters at the stern**
1617

17-
```yaml {filename="hugo.yaml"}
18-
defaultContentLanguage: en
19-
languages:
20-
en:
21-
languageName: English
22-
weight: 1
23-
fr:
24-
languageName: Français
25-
weight: 2
26-
ja:
27-
languageName: 日本語
28-
weight: 3
29-
```
18+
The complete tutorial model is provided within the software and is accessible from the Help menu.
3019

31-
## Manage Translations by Filename
20+
![Tutorial menu](./images/Snipaste_2026-01-27_08-53-13.png)
3221

33-
Hugo supports managing translations by filename. For example, if we have a file `content/docs/_index.md` in English, we can create a file `content/docs/_index.fr.md` for French translation.
22+
---
23+
24+
## 2. Vessel data (Optional)
25+
26+
In a standard DP capability analysis, the first step is to input **vessel data**, which defines the vessel reference frame and serves as a container for thruster positions.
27+
28+
This step is optional but recommended for clarity and future model extension.
29+
30+
> **Note:** The vessel outline is used for visualization only and does **not** affect DP calculation results.
31+
32+
### Vessel outline coordinates
33+
34+
| X (m) | Y (m) |
35+
|------:|------:|
36+
| 120.0 | 0.0 |
37+
| 90.0 | 25.0 |
38+
| -120.0 | 25.0 |
39+
| -120.0 | -25.0 |
40+
| 90.0 | -25.0 |
41+
42+
These outline points are linked together into a closed frame, helping users visually check and confirm the thruster locations relative to the vessel's hull.
43+
44+
---
45+
46+
## 3. Thruster configuration
47+
48+
This vessel configuration includes:
49+
50+
- **Azimuth thrusters (bow)**
51+
Capable of generating thrust in any direction from **0° to 360°**
52+
53+
- **Tunnel thrusters (stern)**
54+
Capable of generating thrust to either **port** or **starboard**
55+
56+
There are **no shaft propellers** in this tutorial case.
57+
58+
---
59+
60+
### 3.1 Thrusters
61+
62+
For each azimuth or tunnel thruster, the following parameters must be defined:
3463

35-
{{< filetree/container >}}
36-
{{< filetree/folder name="content" >}}
37-
{{< filetree/folder name="docs" state="open" >}}
38-
{{< filetree/file name="_index.md" >}}
39-
{{< filetree/file name="_index.fr.md" >}}
40-
{{< filetree/file name="_index.ja.md" >}}
41-
{{< /filetree/folder >}}
42-
{{< /filetree/folder >}}
43-
{{< /filetree/container >}}
64+
- Thruster name
65+
- X coordinate (m)
66+
- Y coordinate (m)
67+
- Propeller diameter (m)
68+
- Maximum power (kW)
69+
- Maximum nominal thrust (kN)
70+
- Default thrust loss factor
4471

45-
Note: Hugo also supports [Translation by content directory](https://gohugo.io/content-management/multilingual/#translation-by-content-directory).
72+
Each thruster is positioned relative to the vessel reference coordinate system. When a thrust loss factor curve is not supplied, the default thrust loss factor is applied to calculate the thrust force. It is especially applicable to azimuth thrusters.
4673

47-
## Translate Menu Items
74+
#### Azimuth Thrusters
4875

49-
To translate menu items in the navigation bar, we need to set the `identifier` field:
76+
| Name | X (m) | Y (m) | Diameter (m) | Max power (kW) | Nominal thrust (kN) | Default thrust loss factor |
77+
|------|------:|------:|-------------:|--------------:|--------------------:|---------------------------:|
78+
| Th1 | -108.6 | -8.2 | 0 | 4,500.00 | 694.428 | 0.9 |
79+
| Th2 | -108.6 | 8.2 | 0 | 4,500.00 | 694.428 | 0.9 |
5080

51-
```yaml {filename="hugo.yaml"}
52-
menu:
53-
main:
54-
- identifier: documentation
55-
name: Documentation
56-
pageRef: /docs
57-
weight: 1
58-
- identifier: blog
59-
name: Blog
60-
pageRef: /blog
61-
weight: 2
62-
```
81+
#### Tunnel Thrusters
82+
83+
| Name | X (m) | Y (m) | Diameter (m) | Max power (kW) | Nominal thrust (kN) | Default thrust loss factor |
84+
|------|------:|------:|-------------:|--------------:|--------------------:|---------------------------:|
85+
| Th3 | 102.8 | 0 | 0 | 2,200.00 | 252.36 | 0.9 |
86+
| Th4 | 96.8 | 0 | 0 | 2,200.00 | 252.36 | 0.9 |
87+
| Th5 | 90.2 | 0 | 0 | 2,200.00 | 252.36 | 0.9 |
88+
89+
The thruster position plot displays each azimuth thruster, tunnel thruster, and shaft propeller using a distinct shape and color for each type. When a thruster is selected in the list, it will be highlighted in the plot accordingly.
90+
91+
![Thruster positions plot](./images/ThrusterPositionPlot.gif)
92+
93+
---
94+
95+
## 5. Failure Mode Definition
96+
97+
### 5.1 Failure Mode Groups
98+
99+
Failure modes are organized into **failure mode groups**, each representing a specific operational scenario, such as:
100+
101+
- Intact condition (all thrusters active)
102+
- Single thruster failure
103+
- Multiple thruster failures
104+
105+
The user must:
106+
107+
1. Create a failure mode group with a meaningful name
108+
2. Define one or more failure modes within the group
109+
3. Specify which thrusters are **active** or **failed** in each mode
110+
111+
---
112+
113+
### 5.2 Azimuth Thruster Restrictions
114+
115+
For azimuth thrusters, additional constraints can be applied:
116+
117+
- **Thrust factor curve** over the full **0–360°** range
118+
- **Multiple forbidden azimuth zones**, where thrust is restricted or not allowed
119+
120+
These settings allow realistic modeling of mechanical, structural, or operational limitations.
121+
122+
---
63123

64-
and translate them in the corresponding i18n file:
124+
## 6. Environmental Load Definition
65125

66-
```yaml {filename="i18n/fr.yaml"}
67-
documentation: Documentation
68-
blog: Blog
69-
```
126+
Environmental loads are required for both **feasibility calculations** and **capability analysis**.
70127

71-
## Translate Strings
128+
### 6.1 Environmental Load Groups
72129

73-
To translate strings on the other places, we need to add the translation to the corresponding i18n file:
130+
Environmental loads are organized into **groups**, each corresponding to a specific wind speed or wind speed series.
131+
132+
In this tutorial, two environmental load groups are used:
133+
134+
1. **Site Loads**
135+
- Used for feasibility calculation
136+
- Represents site-specific environmental conditions
137+
138+
2. **Capability Loads**
139+
- Used for capability analysis
140+
- Includes multiple wind load cases with increasing wind speeds
141+
- Used to determine the **maximum wind speed or CP value** the DP system can withstand
142+
143+
---
144+
145+
## 7. Analysis Settings
146+
147+
In the **Analysis Settings** panel, the user can define:
148+
149+
- **Skipped zones** (heading sectors of no operational interest)
150+
151+
These zones are excluded from calculation to:
152+
153+
- Improve computational efficiency
154+
- Focus on operationally relevant headings only
155+
156+
---
157+
158+
## 8. Feasibility and Capability Analysis
159+
160+
### 8.1 Defining an Analysis Case
161+
162+
A feasibility calculation or capability analysis is defined by combining:
163+
164+
- One **failure mode group**
165+
- One **environmental load group**
166+
167+
Each combination represents a unique DP analysis case.
168+
169+
---
170+
171+
### 8.2 Running Calculations
172+
173+
- Calculations can be run **individually** or **in batch**
174+
- Multiple calculation attempts can be performed to improve solution robustness
175+
176+
Possible outcomes include:
177+
178+
- Feasible solutions found
179+
- No feasible solution found
180+
- Additional calculation attempts required
181+
182+
---
183+
184+
### 8.3 Result Visualization
185+
186+
Once results are available, they can be visualized as:
187+
188+
- **DP capability plots**
189+
- **DP rose plots**
190+
191+
All plots are displayed in the **right-side plotting area** of the software.
192+
193+
---
194+
195+
## 9. Reporting
196+
197+
Since all calculations in this tutorial are pre-computed, the user can directly use the **reporting function**.
198+
199+
Key features include:
200+
201+
- User-selectable report content
202+
- Automatic formatting
203+
- **One-click generation** of a complete DP work report
204+
205+
---
74206

75-
```yaml {filename="i18n/fr.yaml"}
76-
readMore: Lire la suite
77-
```
207+
## 10. Rule Utilities
78208

79-
A list of strings used in the theme can be found in the `i18n/en.yaml` file.
209+
The DP Capability Tool includes built-in **rule utilities** to support industry compliance, including:
80210

81-
## Read More
211+
- **DNV-ST-0111**
212+
- **ABS Guide for Dynamic Positioning Systems**
82213

83-
- [Hugo Multilingual Mode](https://gohugo.io/content-management/multilingual/)
84-
- [Hugo Multilingual Part 1: Content translation](https://www.regisphilibert.com/blog/2018/08/hugo-multilingual-part-1-managing-content-translation/)
85-
- [Hugo Multilingual Part 2: Strings localization](https://www.regisphilibert.com/blog/2018/08/hugo-multilingual-part-2-i18n-string-localization/)
214+
These utilities help verify calculations and interpret results according to class requirements.
32.3 KB
Loading
69.3 KB
Loading
170 KB
Loading
589 KB
Loading
Lines changed: 48 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,48 @@
1+
---
2+
linkTitle: "WindScatterDiagramTool"
3+
title: "Wind scatter diagram tool"
4+
---
5+
6+
<div class="hx-mt-6"></div>
7+
8+
{{< hextra/hero-button text="Download" link="https://github.com/forest-apps/forest-apps.github.io/releases/download/WaveScatterDiagram_Windows_v1.0.0.0/WaveScatterDiagram_Windows_v1.0.0.0.zip" >}}
9+
10+
<div class="hx-mt-6"></div>
11+
12+
Wave Scatter Diagram Tool enables the generation of site-specific wave scatter diagrams worldwide in accordance with DNVGL-RP-C205, supporting offshore structure and mooring design for both Ultimate Limit State (ULS) and Fatigue Limit State (FLS) assessments. It applies the Conditional Modelling Approach (CMA) joint environmental model recommended by DNV, allowing designers to estimate sea state occurrence probabilities in the absence of detailed metocean reports. The tool supports nautical zone–based scatter diagrams using Weibull and Log-Normal distribution parameters for significant wave height (HS) and zero-crossing period (TZ), as well as joint environmental models for North Atlantic and worldwide ship operations. Users can customize bin widths and midpoints, export scatter data to text or Excel formats, and save publication-ready figures for direct inclusion in technical reports.
13+
14+
---
15+
16+
17+
## Key features
18+
19+
20+
{{< cards cols="1" >}}
21+
{{< card
22+
title="Scatter diagram of various nautic zones"
23+
subtitle="Scatter diagram by 2-parameter Weibull parameters and Log-Normal distribution parameters for Hs and Tz (γs = 0) "
24+
image="./images/Snipaste_2026-01-27_11-24-45.png" >}}
25+
26+
{{< card
27+
title="Scatter diagram of Nautic Atlantic"
28+
subtitle="Wave scatter diagrams for the North Atlantic based on both Table C-2 and the joint environmental model"
29+
image="./images/Snipaste_2026-01-27_11-25-54.png" >}}
30+
31+
{{< card
32+
title="Scatter diagram of World Wide"
33+
subtitle="Wave scatter diagrams for the World Wide based on both Table C-3 and the joint environmental model"
34+
image="./images/Snipaste_2026-01-27_11-29-37.png" >}}
35+
36+
{{< card
37+
title="User-defined Hs and Tz bin ranges and bin widths"
38+
subtitle="Users can customize the Hs and Tz bin ranges and bin widths to meet specific project requirements"
39+
image="./images/CustomizeBinWidth.gif" >}}
40+
41+
{{< card
42+
title="Scatter diagram plots and data can be exported in multiple formats"
43+
subtitle="Scatter diagram can be exported as images, plain text files, or Excel spreadsheets"
44+
image="./images/ExportFormats.png" >}}
45+
46+
{{< /cards >}}
47+
48+
---

0 commit comments

Comments
 (0)