Output Formats

CruisePlan generates outputs in multiple formats for different use cases.

Timeline Formats

HTML Schedule

File: {cruise_name}_schedule.html

HTML timeline with:

  • Operation details and timing

  • Detailed scheduling information

  • Expandable sections for each leg

  • Responsive design for mobile/desktop

Best for: Sharing with collaborators, project presentations

NetCDF Data File

File: {cruise_name}_schedule.nc

CF-1.8 compliant NetCDF with:

  • Station coordinates and metadata

  • Operation timing and durations

  • Cruise track as trajectory data

  • Compatible with scientific analysis tools

Best for: Data analysis, archival storage

CSV Schedule

File: {cruise_name}_schedule.csv

Tabular format with columns:

  • Operation name, type, start/end times

  • Coordinates and water depths

  • Duration and distance information

Best for: Spreadsheet analysis, custom processing

Map Outputs

PNG Maps

Files:

  • {cruise_name}_map.png - Station overview (map, process, run)

  • {cruise_name}_schedule.png - Map with transits and ports (schedule, run)

Static maps showing:

  • Station locations and labels

  • Bathymetry contours (optional)

  • Cruise track connections

  • Scale bar and coordinate grid

Best for: Reports, presentations, printing

KML/KMZ Files

File: {cruise_name}_catalog.kml (from map, process, run)

Google Earth format with:

  • Station locations and labels

  • Cruise track as a path

  • Station metadata in pop-up descriptions

Best for: 3D visualization, Google Earth

Document Formats

LaTeX Station Table

Files: {cruise_name}_stations.tex and {cruise_name}_work_days.tex

LaTeX source files (not compiled — run pdflatex yourself to produce PDF):

  • Station table with coordinates and depths

  • Work days at sea table with operation and transit hours

  • Suitable for inclusion in cruise reports or proposals

Best for: Formal proposals, ship time applications

Working Files

YAML Configuration

Files:

  • stations.yaml - Initial configuration from station picker

  • {cruise_name}_enriched.yaml - Enriched configuration with depths and validation

Human-readable configuration containing:

  • All station definitions and metadata

  • Cruise logistics and timing parameters

  • Comments and documentation fields

  • Complete specification for reproducibility

Best for: Configuration management, version control

Pickle Files

Files (from cruiseplan pangaea):

  • {output}_stations.pkl - PANGAEA campaign/station data

  • {output}_dois.txt - DOI list (search mode)

Binary data files for:

  • Fast loading of complex datasets

  • Preserving exact coordinate precision

  • Efficient storage of large station catalogs

Best for: Internal processing, caching

Output Selection

Choose formats based on your needs:

For Proposals:

cruiseplan schedule cruise.yaml --format latex html

For Analysis:

cruiseplan schedule cruise.yaml --format netcdf csv

For Visualization:

cruiseplan schedule cruise.yaml --format html png
cruiseplan map cruise.yaml --format kml

Everything:

cruiseplan schedule cruise.yaml  # All formats

File Naming

All outputs use consistent naming:

  • Base name from YAML cruise_name field

  • Format-specific extensions

  • No spaces (replaced with underscores)

  • Timestamps preserved in metadata

Example for cruise_name: "North Atlantic Survey 2025":

  • North_Atlantic_Survey_2025_schedule.html

  • North_Atlantic_Survey_2025_schedule.nc

  • North_Atlantic_Survey_2025_map.png

For detailed format specifications, see the individual format pages below: