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, |
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
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