cedalion.io.probe_geometry

Module for reading and writing probe geometry files.

Functions

load_tsv(tsv_fname[, crs, units])	Load a tsv file containing optodes or landmarks.
read_digpts(fname[, units])	Read a file containing digitized points.
read_einstar_obj(fname)	Read a textured triangle mesh generated by Einstar devices.
read_mrk_json(fname, crs)	Read a JSON file containing landmarks.
save_mrk_json(fname, landmarks, crs)	Save landmarks to a JSON file.

cedalion.io.probe_geometry.load_tsv(

tsv_fname: str,

crs: str = 'digitized',

units: str = 'mm',

) → DataArray

Load a tsv file containing optodes or landmarks.

Parameters:

• tsv_fname (str) – Path to the tsv file.

• crs (str) – Coordinate reference system of the points.

• units (str)

• Returns

• -------

• xr.DataArray – Optodes or landmarks as a Data

cedalion.io.probe_geometry.read_mrk_json(fname: str, crs: str) → DataArray

Read a JSON file containing landmarks.

Parameters:

• fname (str) – Path to the JSON file.

• crs (str) – Coordinate reference system of the landmarks.

• Returns

• -------

• xr.DataArray – Landmarks as a DataArray.

cedalion.io.probe_geometry.save_mrk_json(fname: str, landmarks: DataArray, crs: str)

Save landmarks to a JSON file.

Parameters:

• fname (str) – Path to the output file.

• landmarks (xr.DataArray) – Landmarks to save.

• crs (str) – Coordinate system of the landmarks.

cedalion.io.probe_geometry.read_digpts(fname: str, units: str = 'mm') → DataArray

Read a file containing digitized points.

Parameters:

• fname (str) – Path to the file.

• units (str) – Units of the points.

• Returns

• -------

• xr.DataArray – Digitized points as a DataArray.

cedalion.io.probe_geometry.read_einstar_obj(fname: str) → TrimeshSurface

Read a textured triangle mesh generated by Einstar devices.

Parameters:

• fname (str) – Path to the file.

• Returns

• -------

• TrimeshSurface – Triangle