Read SeaSonde RCSSY File and Create SeaSondeRCS Object

This function reads a SeaSonde RCSSY file from a specified file path and parses its content into a SeaSondeRCS object. The file is processed by reading its header and body sections using CSSY specifications provided via a YAML file.

Usage

seasonder_readSeaSondeRCSSYFile(
  filepath,
  specs_path = seasonder_defaultSpecsFilePath("CSSY"),
  endian = "big"
)

Arguments

filepath

A character string specifying the path to the SeaSonde RCSSY file.

specs_path

A character string specifying the path to the YAML file containing CSSY specifications. Defaults to the output of seasonder_defaultSpecsFilePath("CSSY").

endian

A character string indicating the byte order used in the file. Defaults to "big".

Value

A SeaSondeRCS object containing the parsed header and data.

Details

The function executes the following steps:

1. Sets up error handling parameters specific to the function.

2. Retrieves YAML specifications for the key size block from the CSSY spec file.

3. Attempts to open the file in binary mode ("rb") with warnings suppressed.

4. Reads the file key and uses it to extract file specs.

5. Reads the header key, retrieves header specs, and parses the CSSY header.

6. Converts the CSSY header into a valid SeaSondeRCS header.

7. Reads the body key, retrieves body specs, and parses the CSSY body.

8. Transforms the CSSY body into a SeaSondeRCS data structure.

9. Combines the header and data into a SeaSondeRCS object.