Skip to content

wildbits/hydro

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

23 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Nano Hydrostatic Library

Features

  • Compute the density of solids made of heterogeneous materials
  • Compute the buoyancy of heterogeneous solids fully immersed in seawater
  • Packaged as OSGI bundle

The library uses the International System of Units. The buoyancy and mass are expressed in kg, the density in kg•m^-3, the volume in m^-3 and temperature in °C.

The buoyancy in seawater is computed based on the seawater density model described in: Sharqawy, Mostafa H., John H. Lienhard V and Syed M. Zubair. "The thermophysical properties of seawater: A review of existing correlations and data." Desalination and Water Treatment, 16 (April 2010) 354–380.

The paper is available on MIT Open Access and usable according to Creative Commons by-nc-sa license. The Equation implemented is the Eq. (8) (referenced in the paper) without modification.

The model is valid for a temperature range 0 < t < 180 °C and salinity range 0 < s < 0.16 kg/kg with a ±0.1% accuracy.

Getting the library

The latest release is 1.0.0 and can be embeded in our project either via maven

<dependency>
  <groupId>org.wildbits</groupId>
  <artifactId>org.wildbits.hydro</artifactId>
  <version>1.0.0</version>
</dependency>

or by downloading the bundle from org.wildbits.hydro-1.0.0.jar

Using the library

The library can be loaded directly in an OSGI container or used in a standalone application.

OSGI container

Once the bundle is activated, the service following services are registrered

  • SolidBuilderFactory which allows to create instances of SolidBuilder
  • SeawaterFactory which allows to create sea water instances of SaltedLiquid

Standalone

Once the library is accessible in the application classpath, the implementation classes SeaWaterImpl and SolidBuilderImpl shall be instanciated directly.

The class org.wildbits.hydro.sample.Sample illustrates how to create a solid composed of 1 m^3 with density 1000 kg•m^-3 and 0.1 m^3 with density 1500 kg•m^-3 and compute its buoyancy in seawater with salinity of 0.08 kg/kg at 20.5 °C.

The first step is to build the solid

Solid<BigDecimal> solid = new SolidBuilderImpl().add(big("1"), big("1000")).add(big("0.1"), big("1500")).build();

Then build the seawater model

Liquid<BigDecimal> seaWater = new SeaWaterImpl(big("0.08"));

Finally the buoyancy and other hydrostatic properties can be computed as follow

BigDecimal mass = solid.mass();
BigDecimal volume = solid.volume();
BigDecimal density = solid.density(big("20.5"));
BigDecimal waterDensity = seaWater.density(big("20.5"));
BigDecimal buoyancy = (waterDensity != null) ? solid.buoyancy(waterDensity) : null;

Notes

The library uses java.math.BigDecimal for its implementation, you may static import the method org.wildbits.hydro.utils.Utils#big as a syntactic sugar making building BigDecimal instances easy.

This software is licensed under the Apache License Version 2.0.