Hydrostatics Object

The hydrostatics object can be used to read the hydrostatics data for a design in Maxsurf and to perform parametric transformations of the design. The following tables of Properties and Methods show all available possibilities for the Hydrostatics Object.

 

Property

Type

Description

BeamWL

Double

Read Only. Gets the waterline beam

BMl

Double

Read Only. Gets the distance from the centre of buoyancy to the longitudinal metacentric height

BMt

Double

Read Only. Gets the distance from the centre of buoyancy to the transverse metacentric height

Cb

Double

Read Only. Gets the block coefficient

Cm

Double

Read Only. Gets the midships coefficient

Cp

Double

Read Only. Gets the prismatic coefficient

Cwp

Double

Read Only. Gets the waterplane coefficient

Displacement

Double

Read Only. Gets the displacement

Draft

Double

Read Only. Gets the height of the DWL from the baseline

GMl

Double

Read Only. Gets the longitudinal metacentric height

GMt

Double

Read Only. Gets the transverse metacentric height

ImmersedDepth

Double

Read Only. Gets the immersed depth of the design

KB

Double

Read Only. Gets the height of the centre of buoyancy from the baseline

KG

Double

Read Only. Gets the height of the centre of gravity from the baseline

KMl

Double

Read Only. Gets the height of the longitudinal metacentre from the baseline

KMt

Double

Read Only. Gets the height of the transverse metacentre from the baseline

LCB

Double

Read Only. Gets the longitudinal centre of buoyancy relative to the datum

LCF

Double

Read Only. Gets the longitudinal centre of floatation relative to the datum

LWL

Double

Read Only. Gets the waterline length

MaxCrossSectArea

Double

Read Only. Gets the maximum cross sectional area

MTc

Double

Read Only. Gets the moment required to change the trim by one centimetre

RM

Double

Read Only. Gets the Righting Moment

TPC

Double

Read Only. Gets the Tonnes per centimetre Immersion for the design.

Volume

Double

Read Only. Gets the immersed volume of the design

WaterplaneArea

Double

Read Only. Gets the waterplane area

WSA

Double

Read Only. Gets the wetted surface area

 

Method

Type

Description

Calculate

Density as Double,

VCG as Double

Calculates / Recalculates the hydrostatic data

Transform

 

 

 

 

 

 

 

 

 

 

 

 

 

     

 

TargetLCB As Double, TargetCoeff As Double, TargetMac As Double, TargetDisp As Double, TargetImmersedDepth As Double, TargetBeam As Double, TargetLWL As Double, DoConstrainDisp As Boolean,
DoConstrainLWL As Boolean, DoConstrainBeam As Boolean,
DoConstrainImmersedDepth As Boolean, OptimiseBlockCoeff As Boolean

Performs a Parametric Transformation of the hull as per Maxsurf’s parametric transformation (Data | Parametric Transformation)

InitAdvancedTransform

 

Initialise Transformation

SetTargetDisp            

DispValue as Double

 

Set the Target Displacement

SetTargetLWL                       

LWLValue as Double

 

Set the Target LWL

SetTargetLBG            

LBGValue as Double

 

Set the Target Length Between Girths

SetTargetGirths         

AGValue as Double, FGValue as Double

 

Set the Target Aft and Forward Girths

SetTargetBeam         

BeamValue as Double

 

Set the Target Waterline BEam

SetTargetDraft           

DraftValue as Double

 

Set the Target Draft

SetTargetLCB            

LCBValue as Double

 

Set the Target Longitudinal Center of Buoyancy

SetTargetBlock          

BlockValue as Double

 

Set the Target Block Coefficient

SetTargetPrismatic    

PrismaticValue as Double

 

Set the Target Prismatic Coefficient

SetTargetMAC           

MACValue as Double

 

Set the Target Midship Area Coefficient

SetTargetFlare           

FlareValue as Double

 

Set the Target Topside Flare

SetTargetLCF

LCFValue as Double

 

Set the Target Longituinal Center of Flotation (not currently enabled)

SetTargetMidbody      

TargetMidbody1 as Double, TargetMidbody2 as Double

 

Set the Target Aft and Forward Midbody positions

SetTargetWPAC

WPACValue as Double

 

Set the Target Waterplane Area Coefficient

AdvancedTransform

 

Perform the transformation

       

 

 

The parametric transformation reads in a large number of variables in order to provide the correct constraints on the transformation. An example showing the use of parametric transformation in the Automation interface is in the Example Creating a Systematic Series on page 68 and Blending Hull Forms on page 73.

 

The Advanced Parametric Transformation is an alternative transformtion function that permits a far larger range of constraints to be specified. To use this function, first call InitAdvancedTransform, then call whichever SetTarget functions you require to specify and constrain your transformation. Once the constraints have been set, call Advanced Transform to complete the transformation.

 

 

See Also:

Hydrostatics on page 22

Tutorial Part 4: Calculating the Hydrostatics on page 31

Hydrostatics Example

To calculate the current hydrostatic data use the Calculate method, with the options for density and VCG

    msDesign.Hydrostatics.Calculate 1025, 2

 

This will set the contents of Cell “B5” to be the vessel displacement

    Range("B5") = msDesign.Hydrostatics.Displacement