Grid1D

Grid1D(
    self,
    x=None,
    *,
    x0=0.0,
    dx=None,
    nx=None,
    projection='NON-UTM',
    origin=(0.0, 0.0),
    orientation=0.0,
    node_coordinates=None,
)

1d spatial grid.

The axis is increasing and equidistant

Parameters

Name Type Description Default
x array_like node coordinates None
x0 float first node coordinate 0.0
dx float grid spacing None
nx int number of nodes None
projection str projection string 'NON-UTM'
origin (float, float) not commonly used (0.0, 0.0)
orientation float not commonly used 0.0
node_coordinates array_like coordinates of nodes in 2D or 3D space None

Examples

import mikeio
mikeio.Grid1D(nx=3,dx=0.1)
<mikeio.Grid1D>
x: [0, 0.1, 0.2] (nx=3, dx=0.1)
mikeio.Grid1D(x=[0.1, 0.5, 0.9])
<mikeio.Grid1D>
x: [0.1, 0.5, 0.9] (nx=3, dx=0.4)

Attributes

Name Description
dx Grid spacing.
is_geo Are coordinates geographical (LONG/LAT)?
is_local_coordinates Are coordinates relative (NON-UTM)?
nx Number of grid points.
projection The projection.
projection_string The projection string.
x Array of node coordinates.

Methods

Name Description
find_index Find nearest point.
get_space_axis Get geographic space axis indices within the geometry’s dims.
isel Get a subset geometry from this geometry.
reduce Return reduced geometry after spatial aggregation.

find_index

Grid1D.find_index(x, **kwargs)

Find nearest point.

Parameters

Name Type Description Default
x float x-coordinate of point required
**kwargs Any Not used {}

Returns

Name Type Description
int index of nearest point

See Also

mikeio.Dataset.sel

get_space_axis

Grid1D.get_space_axis()

Get geographic space axis indices within the geometry’s dims.

Returns which of the geometry’s dims represent geographic space dimensions, as opposed to spectral or other non-geographic dimensions.

This is used when axis=“space” or axis=“spatial” is specified in operations like aggregate, mean, etc.

Returns

Name Type Description
tuple[int, …] Space axis indices (0-indexed within geometry.dims). Returns empty tuple if there are no space dimensions (e.g., point geometries, pure spectral geometries).

Examples

Grid2D with dims=(“y”, “x”) returns (0, 1) - both are space. GeometryFMAreaSpectrum with dims=(“element”, “direction”, “frequency”) returns (0,) - only element is space, direction/frequency are spectral. GeometryFMPointSpectrum with dims=(“frequency”,) returns () - no space.

isel

Grid1D.isel(idx, axis=None)

Get a subset geometry from this geometry.

Parameters

Name Type Description Default
idx int or slice index or slice required
axis int Not used for Grid1D, by default None None

Returns

Name Type Description
Grid1D or GeometryPoint2D or GeometryPoint3D or Geometry0D The geometry of the selection

Examples

import mikeio
g = mikeio.Grid1D(nx=3,dx=0.1)
g
<mikeio.Grid1D>
x: [0, 0.1, 0.2] (nx=3, dx=0.1)
g.isel([1,2])
<mikeio.Grid1D>
x: [0.1, 0.2] (nx=2, dx=0.1)
g.isel(1)
Geometry0D()

reduce

Grid1D.reduce(axis)

Return reduced geometry after spatial aggregation.