Javascript Version

There is also a Javascript version available for use in browser client-side applications:

https://github.com/NOAA-ORR-ERD/jsNUCOS

Latitude Longitude Conversion

There are functions for converting latitude and longitude to/from various formats.

Pass ustring=True to get a Unicode formatted string version.

In [24]: from nucos import LatLongConverter

In [25]: LatLongConverter.ToDecDeg(-45, 34, 12)
Out[25]: -45.57

In [26]: LatLongConverter.ToDecDeg(-45, 34, 12, ustring=True)
Out[26]: '-45.570000°'

In [27]: LatLongConverter.ToDegMin(-45.57)
Out[27]: (-45.0, 34.2)

In [28]: LatLongConverter.ToDegMin(-45.57, ustring=True)
Out[28]: "-45° 34.200'"

In [29]: LatLongConverter.ToDegMinSec(-45.57)
Out[29]: (-45.0, 34, 12.0)

In [30]: LatLongConverter.ToDegMinSec(-45.57, ustring=True)
Out[30]: '-45° 34\' 12.00"'

Unit names

Unit names are simple strings, and there are a lot of synonyms, both in ASCII and Unicode formats.

The full list of units and names is in the NUCOS_unit_list.rst file.

You can programmatically access the unit types, unit names, etc, via assorted utility functions:

# get the names for a given unit type
nucos.get_supported_names('mass')
Out[15]:
['kilogram',
 'kg',
 'kilograms',
 'lb',
 'pounds',
 'lbs',
 'g',
 'grams',
 'mg',
 'µg',
 'ug',
 'tons',
 'uston',
 'tonne',
 'tonnes',
 'metric ton',
 'metric tons',
 'mt',
 'slugs',
 'oz',
 'ounces',
 'ukton',
 'long ton']

# all the available types
In [3]: nucos.get_unit_types()
Out[3]:
['Length',
 'Oil Concentration',
 'Area',
 'Volume',
 'Temperature',
 'Delta Temperature',
 'Mass',
 'Time',
 'Velocity',
 'Discharge',
 'Mass Discharge',
 'Density',
 'Kinematic Viscosity',
 'Dynamic Viscosity',
 'Interfacial Tension',
 'Pressure',
 'Concentration In Water',
 'Concentration',
 'Dimensionless',
 'Mass Fraction',
 'Volume Fraction',
 'Angular Measure',
 'Angular Velocity']


# Get the primary (spelled out) name for a unit
In [5]: nucos.get_primary_name('mg')
Out[5]: 'milligram'

# Get the abbreviation (short form) for a unit:
In [7]: nucos.get_abbreviation('microgram')
Out[7]: 'µg'

Version 3.4.0

Normalized the abbreviations – they should all be now singular, and an actual abbreviation.

NOTE: “bar” (unit of pressure) seems to have no synonyms at all – so made that work

Version 3.3.0

Added a get_primary_names function.

Version 3.2.0

Added a couple utilities for working with the names.

Version 3.1.2

Added some more synonyms for meter per second.

Version 3.1.1

Fixed a bug with GetUnitNames() and capitalization.

Version 3.1.0

Added code to get valid unit names for a given unit_type

Version 3.1.0

Added code to get valid unit names for a given unit_type

Version 3.0

The first release on PyPi – major change in this release is the top-level package name is now nucos – it used to be unit_conversion. The unit_conversion name is still there, but should raise a DeprecationWarning

Development Notes