dapper.surf.sample

dapper module: surf.sample.

Functions

sample_point_values(nc_in, lat, lon, *[, ...])

Backwards-friendly convenience wrapper: opens, samples one point, closes.

Classes

SurfacePointSampler(nc_in, *[, ...])

Efficient point sampler for an ELM surface dataset: opens NetCDF once, samples many points.
class dapper.surf.sample.SurfacePointSampler(nc_in, *, decode_times=True, chunks=None, include=None, exclude=None)[source]

Bases: object

Efficient point sampler for an ELM surface dataset: opens NetCDF once, samples many points.

Parameters:

  • nc_in (str | Path)

  • decode_times (bool)

  • chunks (Optional[Dict[str, int]])

  • include (Optional[set[str]])

  • exclude (Optional[set[str]])

close()[source]

Close any underlying datasets/resources held by the sampler.

Return type:

None

sample(lat, lon)[source]

Sample surface variables at the provided locations and return a dict of arrays.

Return type:

Dict[str, Any]

Parameters:

  • lat (float)

  • lon (float)

dapper.surf.sample.sample_point_values(nc_in, lat, lon, *, decode_times=True, chunks=None, include=None, exclude=None)[source]

Backwards-friendly convenience wrapper: opens, samples one point, closes.

Return type:

Dict[str, Any]

Parameters:

  • nc_in (str | Path)

  • lat (float)

  • lon (float)

  • decode_times (bool)

  • chunks (Dict[str, int] | None)

  • include (set[str] | None)

  • exclude (set[str] | None)