Formats Demo

Demonstration of SeaSenseLib with different input file formats for moored instrumentation.

[1]:

import seasenselib as ssl
import matplotlib.pyplot as plt
import warnings
warnings.filterwarnings('ignore')

plt.style.use('seaborn-v0_8')
plt.rcParams['figure.figsize'] = (12, 4)

SeaBird MicroCAT (CNV Format)

[2]:

# Load SeaBird MicroCAT time series data and plot salinity
microcat_data = ssl.read("../examples/denmark-strait-ds-m1-17.cnv")
ssl.plot('time-series', microcat_data, parameters=['salinity'], title="MicroCAT Salinity Time Series")

INFO:pycnv: Opening file: ../examples/denmark-strait-ds-m1-17.cnv
WARNING:pycnv:Could not compute datetime dates based on timeM
WARNING:pycnv:Could not compute datetime dates based on timeS
INFO:pycnv:Dates computed based on start_date and time_interval

Date
Computing date
_images/demo_mooring-output_3_2.png

Nortek Aquadopp (DAT Format)

Nortek Format Key:

  • ‘nortek-ascii’ - Nortek ASCII format reader

For Nortek Aquadopps, you should use:

aquadopp_data = ssl.read("filename.dat", file_format='nortek-ascii', header_file="filename.hdr")

[3]:

# Load Nortek Aquadopp velocity data and plot u,v components
aquadopp_data = ssl.read("../examples/DSC18_477102.dat",
  file_format='nortek-ascii', header_file="../examples/DSC18_477102.hdr")
ssl.plot('time-series', aquadopp_data, parameters=['east_velocity', 'north_velocity'], title="Aquadopp Velocity Components")
_images/demo_mooring-output_5_0.png

RBR TR1050 Thermistor (MAT Format)

Other formats available include:

  • ‘rbr-rsk’ - Auto reader for RSK files

  • ‘rbr-rsk-default’ - Default RSK reader

  • ‘rbr-rsk-legacy’ - Legacy RSK reader

  • ‘rbr-matlab’ - MATLAB format reader

  • ‘rbr-matlab-legacy’ - Legacy MATLAB format reader

  • ‘rbr-matlab-rsktools’ - MATLAB RSKtools export format

  • ‘rbr-ascii’ - ASCII format reader

[4]:

# Load RBR TR1050 thermistor data from Ruskin MAT export and plot temperature
tr1050_data = ssl.read("../examples/DSE18_013889_20180827_1349.mat", file_format='rbr-matlab')
ssl.plot('time-series', tr1050_data, parameters=['temperature'], title="RBR TR1050 Temperature")
_images/demo_mooring-output_7_0.png

RBR Solo T (RSK Format)

[5]:

# Load RBR Solo T data from native Ruskin format and plot temperature
solo_data = ssl.read("../examples/DSE18_101647_20180827_1551.rsk")
ssl.plot('time-series', solo_data, parameters=['temperature'], title="RBR Solo T Temperature")
_images/demo_mooring-output_9_0.png

SeaSenseLib Format Keys

The following format keys can be used with ssl.read(filename, file_format='key'):

ADCP (Acoustic Doppler Current Profiler):

  • 'adcp-matlab-uhhds': ADCP MATLAB UHHDS format

  • 'adcp-matlab-rdadcp': ADCP MATLAB RDADCP format

CSV/Generic:

  • 'csv': Comma-separated values format

  • 'netcdf': Network Common Data Form

Nortek:

  • 'nortek-ascii': Nortek ASCII format (requires header file)

RBR (Richard Brancker Research):

  • 'rbr-rsk': RBR RSK native format (auto reader)

  • 'rbr-rsk-default': RBR RSK default reader

  • 'rbr-rsk-legacy': RBR RSK legacy format

  • 'rbr-matlab': RBR MATLAB export format

  • 'rbr-matlab-legacy': RBR MATLAB legacy format

  • 'rbr-matlab-rsktools': RBR MATLAB RSKtools export

  • 'rbr-ascii': RBR ASCII format

RCM (Anderaa):

  • 'rcm-matlab': RCM MATLAB format

SeaBird:

  • 'sbe-cnv': SeaBird CNV format

  • 'sbe-ascii': SeaBird ASCII format

Seasun:

  • 'seasun-tob': Seasun TOB format

Usage Example: ```python data = ssl.read(‘filename.ext’, file_format=’format-key’) # For formats requiring header files (e.g., Nortek): data = ssl.read(‘data.dat’, file_format=’nortek-ascii’, header_file=’data.hdr’)