ROMSInputDataset

Contents

Attention

This project is still in an early phase of development.

The python API is not yet stable, and some aspects of the schema for the blueprint and workplan will likely evolve. Therefore whilst you are welcome to try out using the package, we cannot yet guarantee backwards compatibility. We expect to reach a more stable version in 2026.

ROMSInputDataset#

class cstar.roms.input_dataset.ROMSInputDataset(location: str, file_hash: str | None = None, start_date: str | datetime | None = None, end_date: str | datetime | None = None, source_np_xi: int | None = None, source_np_eta: int | None = None, linker: DatasetLinker | None = None)#

Bases: InputDataset, ABC

Describes spatiotemporal data needed to run a unique instance of a ROMS model simulation.

Methods

ROMSInputDataset.get(local_dir)

Obtain and stage this ROMSInputDataset, making it locally available to C-Star.

ROMSInputDataset.partition(np_xi, np_eta[, ...])

Partition a netCDF dataset into tiles to run ROMS in parallel.

ROMSInputDataset.to_dict()

Represent this InputDataset object as a dictionary of kwargs.

Attributes

ROMSInputDataset.end_date

The maximum date in the dataset.

ROMSInputDataset.exists_locally

Check if an unmodified version of this InputDataset exists on the local filesystem.

ROMSInputDataset.log

Return the logger instance for this class.

ROMSInputDataset.partitionable

Set to False if the input dataset should not be partitioned.

ROMSInputDataset.path_for_roms

Returns a list of Paths corresponding to this ROMSInputDataset that can be read by ROMS.

ROMSInputDataset.source_partitioning

ROMSInputDataset.start_date

The minimum date in the dataset.

ROMSInputDataset.working_copy

Describes the (if any) locally available copy of this InputDataset.

ROMSInputDataset.source

The location of and classifies the source data