rompy.swan.subcomponents.readgrid.READINP#

pydantic model rompy.swan.subcomponents.readgrid.READINP[source]#

SWAN input grid reader.

READINP GRID_TYPE [fac] ('fname1' | SERIES 'fname2') [idla] [nhedf] &
    ([nhedt]) [nhedvec] FREE|FORMAT ('form'|idfm)|UNFORMATTED`

Examples

In [100]: from rompy.swan.subcomponents.readgrid import READINP

In [101]: readinp = READINP(
   .....:     grid_type="wind",
   .....:     fname1="wind.txt",
   .....:     fac=1.0,
   .....:     idla=3,
   .....:     format="free",
   .....: )
   .....: 

In [102]: print(readinp.render())
READINP WIND fac=1.0 fname1='wind.txt' idla=3 nhedf=0 nhedt=0 nhedvec=0 FREE
Fields:
Validators:
field fac: float = 1.0#

SWAN multiplies all values that are read from file by fac. For instance if the values are given in unit decimeter, one should make fac=0.1 to obtain values in m. To change sign use a negative fac

Constraints:

  • gt = 0.0

Validated by:

  • check_format_definition

field fname1: str [Required]#

Name of the file with the values of the variable.

Validated by:

  • check_format_definition

field fname2: str | None = None#

Name of file that contains the names of the files where the variables are given when the SERIES option is used. These names are to be given in proper time sequence. SWAN reads the next file when the previous file end has been encountered. In these files the input should be given in the same format as in the above file ‘fname1’ (that implies that a file should start with the start of an input time step)

Validated by:

  • check_format_definition

field form: str | None = None#

A user-specified format string in Fortran convention, e.g., ‘(10X,12F5.0)’.Only used if format=’fixed’, do not use it if idfm is specified

Validated by:

  • check_format_definition

field format: Literal['free', 'fixed', 'unformatted'] = 'free'#

File format, one of ‘free’, ‘fixed’ or ‘unformatted’. If ‘free’, the file is assumed to use the FREE FORTRAN format. If ‘fixed’, the file is assumed to use a fixed format that must be specified by (only) one of ‘form’ or ‘idfm’ arguments. Use ‘unformatted’ to read unformatted (binary) files (not recommended for ordinary use)

Validated by:

  • check_format_definition

field grid_type: GridOptions | None = None#

Type of the SWAN grid file

Validated by:
field idfm: Literal[1, 5, 6, 8] | None = None#

File format identifier, only used if format=’fixed’

Validated by:

  • check_format_definition

field idla: IDLA = 1#

Prescribes the order in which the values of bottom levels and other fields should be given in the file

Validated by:

  • check_format_definition

field model_type: Literal['readinp', 'READINP'] = 'readinp'#

Model type discriminator

Validated by:

  • check_format_definition

field nhedf: int = 0#

The number of header lines at the start of the file. The text in the header lines is reproduced in the print file created by SWAN . The file may start with more header lines than nhedf because the start of the file is often also the start of a time step and possibly also of a vector variable (each having header lines, see nhedt and nhedvec)

Constraints:

  • ge = 0

Validated by:

  • check_format_definition

field nhedt: int = 0#

Only if variable is time dependent: number of header lines in the file at the start of each time level. A time step may start with more header lines than nhedt because the variable may be a vector variable which has its own header lines (see nhedvec)

Constraints:

  • ge = 0

Validated by:

  • check_format_definition

field nhedvec: int = 0#

For each vector variable: number of header lines in the file at the start of each component (e.g., x- or y-component)

Constraints:

  • ge = 0

Validated by:

  • check_format_definition

cmd() → str[source]#
validator set_undefined  »  grid_type[source]#

Allow for undefined value so it can be redefined in INPGRID components.

On this page
Show Source