nwb

`sleap_io.io.nwb` ¶

Functions to write and read from the neurodata without borders (NWB) format.

Functions:

Name	Description
`append_nwb`	Append a SLEAP `Labels` object to an existing NWB data file.
`append_nwb_data`	Append data from a Labels object to an in-memory nwb file.
`build_pose_estimation_container_for_track`	Create a PoseEstimation container for a track.
`build_track_pose_estimation_list`	Build a list of PoseEstimationSeries from tracks.
`convert_predictions_to_dataframe`	Convert predictions data to a Pandas dataframe.
`create_skeleton_container`	Create NWB skeleton containers from SLEAP skeletons.
`get_processing_module_for_video`	Auxiliary function to create a processing module.
`get_timestamps`	Return a vector of timestamps for a `PoseEstimationSeries`.
`read_nwb`	Read an NWB formatted file to a SLEAP `Labels` object.
`write_nwb`	Write labels to an nwb file and save it to the nwbfile_path given.

`append_nwb(labels, filename, pose_estimation_metadata=None)` ¶

Append a SLEAP Labels object to an existing NWB data file.

Parameters:

Name	Type	Description	Default
`labels`	`Labels`	A general `Labels` object.	required
`filename`	`str`	The path to the NWB file.	required
`pose_estimation_metadata`	`Optional[dict]`	Metadata for pose estimation. See `append_nwb_data` for details.	`None`

`append_nwb_data(labels, nwbfile, pose_estimation_metadata=None, skeleton_map=None)` ¶

Append data from a Labels object to an in-memory nwb file.

Parameters:

Name	Type	Description	Default
`labels`	`Labels`	A general labels object	required
`nwbfile`	`NWBFile`	And in-memory nwbfile where the data is to be appended.	required
`pose_estimation_metadata`	`Optional[dict]`	This argument has a dual purpose: 1) It can be used to pass time information about the video which is necessary for synchronizing frames in pose estimation tracking to other modalities. Either the video timestamps can be passed to This can be used to pass the timestamps with the key `video_timestamps` or the sampling rate with key`video_sample_rate`. e.g. pose_estimation_metadata["video_timestamps"] = np.array(timestamps) or pose_estimation_metadata["video_sample_rate"] = 15 # In Hz 2) The other use of this dictionary is to overwrite sleap-io default arguments for the PoseEstimation container. see https://github.com/rly/ndx-pose for a full list or arguments.	`None`
`skeleton_map`	`Optional[Dict[str, Skeleton]]`	Mapping of skeleton names to NWB Skeleton objects.	`None`

Returns:

Type	Description
`NWBFile`	An in-memory nwbfile with the data from the labels object appended.

Source code in sleap_io/io/nwb.py

def append_nwb_data(
    labels: Labels,
    nwbfile: NWBFile,
    pose_estimation_metadata: Optional[dict] = None,
    skeleton_map: Optional[Dict[str, Skeleton]] = None,
) -> NWBFile:
    """Append data from a Labels object to an in-memory nwb file.

    Args:
        labels: A general labels object
        nwbfile: And in-memory nwbfile where the data is to be appended.
        pose_estimation_metadata: This argument has a dual purpose:

            1) It can be used to pass time information about the video which is
            necessary for synchronizing frames in pose estimation tracking to other
            modalities. Either the video timestamps can be passed to
            This can be used to pass the timestamps with the key `video_timestamps`
            or the sampling rate with key`video_sample_rate`.

            e.g. pose_estimation_metadata["video_timestamps"] = np.array(timestamps)
            or   pose_estimation_metadata["video_sample_rate"] = 15  # In Hz

            2) The other use of this dictionary is to overwrite sleap-io default
            arguments for the PoseEstimation container.
            see https://github.com/rly/ndx-pose for a full list or arguments.
        skeleton_map: Mapping of skeleton names to NWB Skeleton objects.

    Returns:
        An in-memory nwbfile with the data from the labels object appended.
    """
    pose_estimation_metadata = pose_estimation_metadata or dict()
    if skeleton_map is None:
        skeleton_map = create_skeleton_container(labels=labels, nwbfile=nwbfile)

    # Extract default metadata
    provenance = labels.provenance
    default_metadata = dict(scorer=str(provenance))
    sleap_version = provenance.get("sleap_version", None)
    default_metadata["source_software_version"] = sleap_version

    labels_data_df = convert_predictions_to_dataframe(labels)

    # For every video create a processing module
    for video_index, video in enumerate(labels.videos):
        video_path = Path(video.filename)
        processing_module_name = f"SLEAP_VIDEO_{video_index:03}_{video_path.stem}"
        nwb_processing_module = get_processing_module_for_video(
            processing_module_name, nwbfile
        )

        device_name = f"camera_{video_index}"
        if device_name in nwbfile.devices:
            device = nwbfile.devices[device_name]
        else:
            device = nwbfile.create_device(
                name=device_name,
                description=f"Camera for {video_path.name}",
                manufacturer="Unknown",
            )

        # Propagate video metadata
        default_metadata["original_videos"] = [f"{video.filename}"]  # type: ignore
        default_metadata["labeled_videos"] = [f"{video.filename}"]  # type: ignore

        # Overwrite default with the user provided metadata
        default_metadata.update(pose_estimation_metadata)

        # For every track in that video create a PoseEstimation container
        name_of_tracks_in_video = (
            labels_data_df[video.filename]
            .columns.get_level_values("track_name")
            .unique()
        )

        for track_index, track_name in enumerate(name_of_tracks_in_video):
            pose_estimation_container = build_pose_estimation_container_for_track(
                labels_data_df,
                labels,
                track_name,
                video,
                default_metadata,
                skeleton_map,
                devices=[device],
            )
            nwb_processing_module.add(pose_estimation_container)

    return nwbfile

`build_pose_estimation_container_for_track(labels_data_df, labels, track_name, video, pose_estimation_metadata, skeleton_map, devices=None)` ¶

Create a PoseEstimation container for a track.

Parameters:

Name	Type	Description	Default
`labels_data_df`	`DataFrame`	A pandas object with the data corresponding to the predicted instances associated to this labels object.	required
`labels`	`Labels`	A general labels object	required
`track_name`	`str`	The name of the track in labels.tracks	required
`video`	`Video`	The video to which data belongs to	required
`pose_estimation_metadata`	`dict`	(dict) Metadata for pose estimation. See `append_nwb_data`	required
`skeleton_map`	`Dict[str, Skeleton]`	Mapping of skeleton names to NWB Skeleton objects	required
`skeleton_map`	`Dict[str, Skeleton]`	Mapping of skeleton names to NWB Skeleton objects	required
`devices`	`Optional[List]`	Optional list of recording devices	`None`

Returns: PoseEstimation: A PoseEstimation multicontainer where the time series of all the node trajectories in the track are stored. One time series per node.

Source code in sleap_io/io/nwb.py

def build_pose_estimation_container_for_track(
    labels_data_df: pd.DataFrame,
    labels: Labels,
    track_name: str,
    video: Video,
    pose_estimation_metadata: dict,
    skeleton_map: Dict[str, Skeleton],
    devices: Optional[List] = None,
) -> PoseEstimation:
    """Create a PoseEstimation container for a track.

    Args:
        labels_data_df (pd.DataFrame): A pandas object with the data corresponding
            to the predicted instances associated to this labels object.
        labels (Labels): A general labels object
        track_name (str): The name of the track in labels.tracks
        video (Video): The video to which data belongs to
        pose_estimation_metadata: (dict) Metadata for pose estimation. See `append_nwb_data`
        skeleton_map: Mapping of skeleton names to NWB Skeleton objects
        skeleton_map: Mapping of skeleton names to NWB Skeleton objects
        devices: Optional list of recording devices
    Returns:
        PoseEstimation: A PoseEstimation multicontainer where the time series
        of all the node trajectories in the track are stored. One time series per
        node.
    """
    # Copy metadata for local use and modification
    pose_estimation_metadata_copy = deepcopy(pose_estimation_metadata)
    video_path = Path(video.filename)

    all_track_skeletons = (
        labels_data_df[video.filename]
        .columns.get_level_values("skeleton_name")
        .unique()
    )

    # Assuming only one skeleton per track
    skeleton_name = all_track_skeletons[0]
    sleap_skeleton = next(
        skeleton for skeleton in labels.skeletons if skeleton.name == skeleton_name
    )
    nwb_skeleton = skeleton_map[skeleton_name]

    # Get track data
    track_data_df = labels_data_df[
        video.filename,
        sleap_skeleton.name,
        track_name,
    ]

    # Combine each node's PoseEstimationSeries to create a PoseEstimation container
    timestamps = pose_estimation_metadata_copy.pop("video_timestamps", None)
    sample_rate = pose_estimation_metadata_copy.pop("video_sample_rate", 1.0)
    if timestamps is None:
        # Keeps backward compatibility.
        timestamps = np.arange(track_data_df.shape[0]) * sample_rate
    else:
        timestamps = np.asarray(timestamps)

    pose_estimation_series_list = build_track_pose_estimation_list(
        track_data_df, timestamps
    )

    # Arrange and mix metadata
    pose_estimation_container_kwargs = dict(
        name=f"track={track_name}",
        description=f"Estimated positions of {sleap_skeleton.name} in video {video_path.name}",
        pose_estimation_series=pose_estimation_series_list,
        skeleton=nwb_skeleton,
        source_software="SLEAP",
        # dimensions=np.array([[video.height, video.width]], dtype="uint16"),
        devices=devices or [],
    )

    pose_estimation_container_kwargs.update(**pose_estimation_metadata_copy)
    pose_estimation_container = PoseEstimation(**pose_estimation_container_kwargs)

    return pose_estimation_container

`build_track_pose_estimation_list(track_data_df, timestamps)` ¶

Build a list of PoseEstimationSeries from tracks.

Parameters:

Name	Type	Description	Default
`track_data_df`	`DataFrame`	A pandas DataFrame containing the trajectories for all the nodes associated with a specific track.	required
`timestamps`	`ArrayLike`	Array of timestamps for the data points	required

Returns:

Type	Description
`List[PoseEstimationSeries]`	List of PoseEstimationSeries, one for each node.

Source code in sleap_io/io/nwb.py

def build_track_pose_estimation_list(
    track_data_df: pd.DataFrame, timestamps: ArrayLike
) -> List[PoseEstimationSeries]:
    """Build a list of PoseEstimationSeries from tracks.

    Args:
        track_data_df: A pandas DataFrame containing the trajectories
            for all the nodes associated with a specific track.
        timestamps: Array of timestamps for the data points

    Returns:
        List of PoseEstimationSeries, one for each node.
    """
    name_of_nodes_in_track = track_data_df.columns.get_level_values(
        "node_name"
    ).unique()

    pose_estimation_series_list: List[PoseEstimationSeries] = []
    for node_name in name_of_nodes_in_track:
        # Drop data with missing values
        data_for_node = track_data_df[node_name].dropna(axis="index", how="any")

        node_trajectory = data_for_node[["x", "y"]].to_numpy()
        confidence = data_for_node["score"].to_numpy()

        reference_frame = (
            "The coordinates are in (x, y) relative to the top-left of the image. "
            "Coordinates refer to the midpoint of the pixel. "
            "That is, the midpoint of the top-left pixel is at (0, 0), whereas "
            "the top-left corner of that same pixel is at (-0.5, -0.5)."
        )

        pose_estimation_kwargs = dict(
            name=f"{node_name}",
            description=f"Sequential trajectory of {node_name}.",
            data=node_trajectory,
            unit="pixels",
            reference_frame=reference_frame,
            confidence=confidence,
            confidence_definition="Point-wise confidence scores.",
        )

        # Add timestamps or only rate if the timestamps are uniform
        frames = data_for_node.index.values
        timestamps_for_data = timestamps[frames]  # type: ignore[index]
        sample_periods = np.diff(timestamps_for_data)
        if sample_periods.size == 0:
            rate = None  # This is the case with only one data point
        else:
            # Difference below 0.1 ms do not matter for behavior in videos
            uniform_samples = np.unique(sample_periods.round(5)).size == 1
            rate = 1 / sample_periods[0] if uniform_samples else None

        if rate:
            # Video sample rates are ints but nwb expect floats
            rate = float(int(rate))
            pose_estimation_kwargs.update(
                rate=rate, starting_time=timestamps_for_data[0]
            )
        else:
            pose_estimation_kwargs.update(timestamps=timestamps_for_data)

        # Build the pose estimation object and attach it to the list
        pose_estimation_series = PoseEstimationSeries(**pose_estimation_kwargs)
        pose_estimation_series_list.append(pose_estimation_series)

    return pose_estimation_series_list

`convert_predictions_to_dataframe(labels)` ¶

Convert predictions data to a Pandas dataframe.

Parameters:

Name	Type	Description	Default
`labels`	`Labels`	A general label object.	required

Returns:

Type	Description
`DataFrame`	pd.DataFrame: A pandas data frame with the structured data with hierarchical columns. The column hierarchy is: "video_path", "skeleton_name", "track_name", "node_name", And it is indexed by the frames.

Raises:

Type	Description
`ValueError`	If no frames in the label objects contain predicted instances.

Source code in sleap_io/io/nwb.py

def convert_predictions_to_dataframe(labels: Labels) -> pd.DataFrame:
    """Convert predictions data to a Pandas dataframe.

    Args:
        labels: A general label object.

    Returns:
        pd.DataFrame: A pandas data frame with the structured data with
        hierarchical columns. The column hierarchy is:
                "video_path",
                "skeleton_name",
                "track_name",
                "node_name",
        And it is indexed by the frames.

    Raises:
        ValueError: If no frames in the label objects contain predicted instances.
    """
    # Form pairs of labeled_frames and predicted instances
    labeled_frames = labels.labeled_frames
    all_frame_instance_tuples = (
        (label_frame, instance)  # type: ignore
        for label_frame in labeled_frames
        for instance in label_frame.predicted_instances
    )

    # Extract the data
    data_list = list()
    for labeled_frame, instance in all_frame_instance_tuples:
        # Traverse the nodes of the instances's skeleton
        skeleton = instance.skeleton
        for node in skeleton.nodes:
            row_dict = dict(
                frame_idx=labeled_frame.frame_idx,
                x=instance[node]["xy"][0],
                y=instance[node]["xy"][1],
                score=instance[node]["score"],
                node_name=node.name,
                skeleton_name=skeleton.name,
                track_name=instance.track.name if instance.track else "untracked",
                video_path=labeled_frame.video.filename,
            )
            data_list.append(row_dict)

    if not data_list:
        raise ValueError("No predicted instances found in labels object")

    labels_df = pd.DataFrame(data_list)

    # Reformat the data with columns for dict-like hierarchical data access.
    index = [
        "skeleton_name",
        "track_name",
        "node_name",
        "video_path",
        "frame_idx",
    ]

    labels_tidy_df = (
        labels_df.set_index(index)
        .unstack(level=[0, 1, 2, 3])
        .swaplevel(0, -1, axis=1)  # video_path on top while x, y score on bottom
        .sort_index(axis=1)  # Better format for columns
        .sort_index(axis=0)  # Sorts by frames
    )

    return labels_tidy_df

`create_skeleton_container(labels, nwbfile)` ¶

Create NWB skeleton containers from SLEAP skeletons.

Parameters:

Name	Type	Description	Default
`labels`	`Labels`	SLEAP Labels object containing skeleton definitions	required
`nwbfile`	`NWBFile`	NWB file to add skeletons to	required

Returns:

Type	Description
`Dict[str, Skeleton]`	Dictionary mapping skeleton names to NWB Skeleton objects

Source code in sleap_io/io/nwb.py

def create_skeleton_container(
    labels: Labels,
    nwbfile: NWBFile,
) -> Dict[str, Skeleton]:
    """Create NWB skeleton containers from SLEAP skeletons.

    Args:
        labels: SLEAP Labels object containing skeleton definitions
        nwbfile: NWB file to add skeletons to

    Returns:
        Dictionary mapping skeleton names to NWB Skeleton objects
    """
    skeleton_map = {}
    nwb_skeletons = []

    # Get or create behavior processing module
    behavior_pm = nwbfile.processing.get("behavior")
    if behavior_pm is None:
        behavior_pm = nwbfile.create_processing_module(
            name="behavior", description="processed behavioral data"
        )

    # Check if Skeletons container already exists
    existing_skeletons = None
    if "Skeletons" in behavior_pm.data_interfaces:
        existing_skeletons = behavior_pm.data_interfaces["Skeletons"]
        # Add existing skeletons to our map
        for skeleton_name in existing_skeletons.skeletons:
            nwb_skeleton = existing_skeletons.skeletons[skeleton_name]
            skeleton_map[skeleton_name] = nwb_skeleton

    # Create new skeletons for ones that don't exist yet
    for sleap_skeleton in labels.skeletons:
        if sleap_skeleton.name not in skeleton_map:
            nwb_skeleton = Skeleton(
                name=sleap_skeleton.name,
                nodes=sleap_skeleton.node_names,
                edges=np.array(sleap_skeleton.edge_inds, dtype="uint8"),
            )
            nwb_skeletons.append(nwb_skeleton)
            skeleton_map[sleap_skeleton.name] = nwb_skeleton

    # If we have new skeletons to add
    if nwb_skeletons:
        if existing_skeletons is None:
            # Create new Skeletons container if none exists
            skeletons_container = Skeletons(skeletons=nwb_skeletons)
            behavior_pm.add(skeletons_container)
        else:
            # Add new skeletons to existing container
            for skeleton in nwb_skeletons:
                existing_skeletons.add_skeleton(skeleton)

    return skeleton_map

`get_processing_module_for_video(processing_module_name, nwbfile)` ¶

Auxiliary function to create a processing module.

Checks for the processing module existence and creates if not available.

Parameters:

Name	Type	Description	Default
`processing_module_name`	`str`	The name of the processing module.	required
`nwbfile`	`NWBFile`	The nwbfile to attach the processing module to.	required

Returns:

Name	Type	Description
`ProcessingModule`	`ProcessingModule`	An nwb processing module with the desired name.

Source code in sleap_io/io/nwb.py

def get_processing_module_for_video(
    processing_module_name: str, nwbfile: NWBFile
) -> ProcessingModule:
    """Auxiliary function to create a processing module.

    Checks for the processing module existence and creates if not available.

    Args:
        processing_module_name (str): The name of the processing module.
        nwbfile (NWBFile): The nwbfile to attach the processing module to.

    Returns:
        ProcessingModule: An nwb processing module with the desired name.
    """
    description = "Processed SLEAP data"
    processing_module = (
        nwbfile.processing[processing_module_name]
        if processing_module_name in nwbfile.processing
        else nwbfile.create_processing_module(
            name=processing_module_name, description=description
        )
    )
    return processing_module

`get_timestamps(series)` ¶

Return a vector of timestamps for a PoseEstimationSeries.

Source code in sleap_io/io/nwb.py

def get_timestamps(series: PoseEstimationSeries) -> np.ndarray:
    """Return a vector of timestamps for a `PoseEstimationSeries`."""
    if series.timestamps is not None:
        return np.asarray(series.timestamps)
    else:
        return np.arange(series.data.shape[0]) * series.rate + series.starting_time

`read_nwb(path)` ¶

Read an NWB formatted file to a SLEAP Labels object.

Parameters:

Name	Type	Description	Default
`path`	`str`	Path to an NWB file (`.nwb`).	required

Returns:

Type	Description
`Labels`	A `Labels` object.

Source code in sleap_io/io/nwb.py

def read_nwb(path: str) -> Labels:
    """Read an NWB formatted file to a SLEAP `Labels` object.

    Args:
        path: Path to an NWB file (`.nwb`).

    Returns:
        A `Labels` object.
    """
    with NWBHDF5IO(path, mode="r", load_namespaces=True) as io:
        read_nwbfile = io.read()
        nwb_file_processing = read_nwbfile.processing

        # Get list of videos
        video_keys: List[str] = [
            key for key in nwb_file_processing.keys() if "SLEAP_VIDEO" in key
        ]
        video_tracks = dict()

        # Get track keys from first video's processing module
        test_processing_module: ProcessingModule = nwb_file_processing[video_keys[0]]
        track_keys: List[str] = list(test_processing_module.fields["data_interfaces"])

        # Get first track's skeleton
        test_pose_estimation: PoseEstimation = test_processing_module[track_keys[0]]
        skeleton = test_pose_estimation.skeleton
        skeleton_nodes = skeleton.nodes[:]
        skeleton_edges = skeleton.edges[:]

        # Filtering out behavior module with skeletons
        pose_estimation_container_modules = [
            nwb_file_processing[key] for key in video_keys
        ]

        for processing_module in pose_estimation_container_modules:
            # Get track keys
            _track_keys: List[str] = list(processing_module.fields["data_interfaces"])
            is_tracked: bool = re.sub("[0-9]+", "", _track_keys[0]) == "track"

            # Figure out the max number of frames and the canonical timestamps
            timestamps = np.empty(())
            for track_key in _track_keys:
                pose_estimation = processing_module[track_key]
                for node_name in skeleton.nodes:
                    pose_estimation_series = pose_estimation[node_name]
                    timestamps = np.union1d(
                        timestamps, get_timestamps(pose_estimation_series)
                    )
            timestamps = np.sort(timestamps)

            # Recreate Labels numpy (same as output of Labels.numpy())
            n_tracks = len(_track_keys)
            n_frames = len(timestamps)
            n_nodes = len(skeleton.nodes)
            tracks_numpy = np.full((n_frames, n_tracks, n_nodes, 2), np.nan, np.float32)
            confidence = np.full((n_frames, n_tracks, n_nodes), np.nan, np.float32)

            for track_idx, track_key in enumerate(_track_keys):
                pose_estimation = processing_module[track_key]
                for node_idx, node_name in enumerate(skeleton.nodes):
                    pose_estimation_series = pose_estimation[node_name]
                    frame_inds = np.searchsorted(
                        timestamps, get_timestamps(pose_estimation_series)
                    )
                    tracks_numpy[frame_inds, track_idx, node_idx, :] = (
                        pose_estimation_series.data[:]
                    )
                    confidence[frame_inds, track_idx, node_idx] = (
                        pose_estimation_series.confidence[:]
                    )

            video_tracks[Path(pose_estimation.original_videos[0]).as_posix()] = (
                tracks_numpy,
                confidence,
                is_tracked,
            )

    # Create SLEAP skeleton from NWB skeleton
    sleap_skeleton = SleapSkeleton(
        nodes=skeleton_nodes,
        edges=skeleton_edges.tolist(),
    )

    # Add instances to labeled frames
    lfs = []
    for video_fn, (tracks_numpy, confidence, is_tracked) in video_tracks.items():
        video = Video(filename=video_fn)
        n_frames, n_tracks, n_nodes, _ = tracks_numpy.shape
        tracks = [Track(name=f"track{track_idx}") for track_idx in range(n_tracks)]

        for frame_idx, (frame_pts, frame_confs) in enumerate(
            zip(tracks_numpy, confidence)
        ):
            insts: List[Union[Instance, PredictedInstance]] = []
            for track, (inst_pts, inst_confs) in zip(
                tracks, zip(frame_pts, frame_confs)
            ):
                if np.isnan(inst_pts).all():
                    continue
                insts.append(
                    PredictedInstance.from_numpy(
                        points_data=np.column_stack(
                            [inst_pts, inst_confs]
                        ),  # (n_nodes, 3)
                        score=inst_confs.mean(),  # ()
                        skeleton=sleap_skeleton,
                        track=track if is_tracked else None,
                    )
                )
            if len(insts) > 0:
                lfs.append(
                    LabeledFrame(video=video, frame_idx=frame_idx, instances=insts)
                )

    labels = Labels(lfs)
    labels.provenance["filename"] = path
    return labels

`write_nwb(labels, nwbfile_path, nwb_file_kwargs=None, pose_estimation_metadata=None)` ¶

Write labels to an nwb file and save it to the nwbfile_path given.

Parameters:

Name	Type	Description	Default
`labels`	`Labels`	A general `Labels` object.	required
`nwbfile_path`	`str`	The path where the nwb file is to be written.	required
`nwb_file_kwargs`	`Optional[dict]`	A dict containing metadata to the nwbfile. Example: nwb_file_kwargs = { 'session_description: 'your_session_description', 'identifier': 'your session_identifier', } For a full list of possible values see: https://pynwb.readthedocs.io/en/stable/pynwb.file.html#pynwb.file.NWBFile Defaults to None and default values are used to generate the nwb file.	`None`
`pose_estimation_metadata`	`Optional[dict]`	This argument has a dual purpose: 1) It can be used to pass time information about the video which is necessary for synchronizing frames in pose estimation tracking to other modalities. Either the video timestamps can be passed to This can be used to pass the timestamps with the key `video_timestamps` or the sampling rate with key`video_sample_rate`. e.g. pose_estimation_metadata["video_timestamps"] = np.array(timestamps) or pose_estimation_metadata["video_sample_rate] = 15 # In Hz 2) The other use of this dictionary is to overwrite sleap-io default arguments for the PoseEstimation container. see https://github.com/rly/ndx-pose for a full list or arguments.	`None`

Source code in sleap_io/io/nwb.py

def write_nwb(
    labels: Labels,
    nwbfile_path: str,
    nwb_file_kwargs: Optional[dict] = None,
    pose_estimation_metadata: Optional[dict] = None,
):
    """Write labels to an nwb file and save it to the nwbfile_path given.

    Args:
        labels: A general `Labels` object.
        nwbfile_path: The path where the nwb file is to be written.
        nwb_file_kwargs: A dict containing metadata to the nwbfile. Example:
            nwb_file_kwargs = {
                'session_description: 'your_session_description',
                'identifier': 'your session_identifier',
            }
            For a full list of possible values see:
            https://pynwb.readthedocs.io/en/stable/pynwb.file.html#pynwb.file.NWBFile

            Defaults to None and default values are used to generate the nwb file.

        pose_estimation_metadata: This argument has a dual purpose:

            1) It can be used to pass time information about the video which is
            necessary for synchronizing frames in pose estimation tracking to other
            modalities. Either the video timestamps can be passed to
            This can be used to pass the timestamps with the key `video_timestamps`
            or the sampling rate with key`video_sample_rate`.

            e.g. pose_estimation_metadata["video_timestamps"] = np.array(timestamps)
            or   pose_estimation_metadata["video_sample_rate] = 15  # In Hz

            2) The other use of this dictionary is to overwrite sleap-io default
            arguments for the PoseEstimation container.
            see https://github.com/rly/ndx-pose for a full list or arguments.
    """
    nwb_file_kwargs = nwb_file_kwargs or dict()

    # Add required values for nwbfile if not present
    session_description = nwb_file_kwargs.get(
        "session_description", "Processed SLEAP pose data"
    )
    session_start_time = nwb_file_kwargs.get(
        "session_start_time", datetime.datetime.now(datetime.timezone.utc)
    )
    identifier = nwb_file_kwargs.get("identifier", str(uuid.uuid1()))

    nwb_file_kwargs.update(
        session_description=session_description,
        session_start_time=session_start_time,
        identifier=identifier,
    )

    nwbfile = NWBFile(**nwb_file_kwargs)

    # Create skeleton containers first
    skeleton_map = create_skeleton_container(labels, nwbfile)

    # Then append pose data
    nwbfile = append_nwb_data(labels, nwbfile, pose_estimation_metadata, skeleton_map)

    with NWBHDF5IO(str(nwbfile_path), "w") as io:
        io.write(nwbfile)

nwb

sleap_io.io.nwb ¶

append_nwb(labels, filename, pose_estimation_metadata=None) ¶

append_nwb_data(labels, nwbfile, pose_estimation_metadata=None, skeleton_map=None) ¶

build_pose_estimation_container_for_track(labels_data_df, labels, track_name, video, pose_estimation_metadata, skeleton_map, devices=None) ¶

build_track_pose_estimation_list(track_data_df, timestamps) ¶

convert_predictions_to_dataframe(labels) ¶

create_skeleton_container(labels, nwbfile) ¶

get_processing_module_for_video(processing_module_name, nwbfile) ¶

get_timestamps(series) ¶

read_nwb(path) ¶

write_nwb(labels, nwbfile_path, nwb_file_kwargs=None, pose_estimation_metadata=None) ¶

`sleap_io.io.nwb` ¶

`append_nwb(labels, filename, pose_estimation_metadata=None)` ¶

`append_nwb_data(labels, nwbfile, pose_estimation_metadata=None, skeleton_map=None)` ¶

`build_pose_estimation_container_for_track(labels_data_df, labels, track_name, video, pose_estimation_metadata, skeleton_map, devices=None)` ¶

`build_track_pose_estimation_list(track_data_df, timestamps)` ¶

`convert_predictions_to_dataframe(labels)` ¶

`create_skeleton_container(labels, nwbfile)` ¶

`get_processing_module_for_video(processing_module_name, nwbfile)` ¶

`get_timestamps(series)` ¶

`read_nwb(path)` ¶

`write_nwb(labels, nwbfile_path, nwb_file_kwargs=None, pose_estimation_metadata=None)` ¶