Examples

Wiki ▸ Examples

Demonstrations of library applications. You can access them on: https://shiplab.github.io/vesseljs/examples/.

Tutorials and live examples:

• Object Visualization
• Object Weight and CG
• Load a Vessel Specification
• Visualization and Detailing of Ship Specification
• Hull Definition and Hydrostatics
• Stability
• Validation of Ship Stability Calculation

Below are some examples of how the library can be used, along with other libraries and custom scripts.

Ship Motions

Ship_in_Ocean_still_water.html

Even simpler version.

Ship_in_Ocean_heave_only.html

Simpler version of the above demo.

Ship_in_configurable_ocean.html

A 3D ship made from a ship specification, moving with waves in a configurable ocean. Note that the motion is not at all physically correct.

Many_ships_in_still_water.html

Many ships in still water.

Many_ships_in_configurable_ocean.html

Many ships in configurable ocean.

Many_ships_Jensen_defective.html

An attempt at showing more realistic motion. This example has unresolved issues.

Ship_in_regular_ocean.html

A 3D ship made from a ship specification, moving with waves in a regular wave ocean. Motion calculated with closed-form expressions.

Many_ships_in_regular_ocean.html

Many ships in a regular wave ocean. Motion calculated with closed-form expressions.

make_strip.html

Convert a ship specification into input files for strip theory analyses.

lifting.html

Pendulum motion of load hanging from an A-frame.

Fuel Consumption

path.html

Estimation of fuel consumption of vessel sailing through a certain path and wave pattern.

lifecycle.html

Evaluation of vessel suitability for a given operating region based on the fuel consumption in transit.

Hydrostatics and Stability

TDvsBU.html

Comparison of hydrostatics and stability results between top-down and bottom-up approaches.

loading.html

Simulation of draft and GM during cargo loading in a simple barge.

ballasting.html

Simulation of draft and GM during cargo loading and ballast unloading.

blockCase_compare.html

Comparison between manual and automatic calculations on a very simple ship.

Hull_hydrostatics.html

This app calculates hydrostatic properties of a hull, with a slider to control the draft.

Ship_stability_with_blocks.html

Calculation of ship stability properties with configurable cargo blocks.

3D Visualizations and General Arrangement

Ship3D_GA.html

Orthographic views of each deck of a ship.

Ship3D_with_pretty_JSON.html

A 3D visualization of the provided ship specification, along with the specification data in a format with expand and collapse.

Ship Specification

scaleApp.html

Create a new ship specification by linearly scaling a parent one.

Tests

Ship3D_test.html

A fullscreen 3D visualization of an example ship specification (based on Ulstein PX121).

PX121_calculations.html

Some calculations on a test specification partially based on an Ulstein vessel.

Ship3D_load_state_controls.html

Very simple test of changing tank fullness with a slider to see change of draft.

blockCase_compare_json.html

A field by field comparison, to verify library calculations.

Hull_Weight.html

A field by field comparison of different hull weight estimation methods.

Ship_in_Ocean_dynamical.html

Dynamical system of a 6DOF model vessel.