sign-language-data-loading 1.0.2

Efficient data loading utilities for sign language datasets.

sign-language-data-loading (sldl)

Efficient, PyTorch-friendly data loading for sign language datasets stored as WebDataset shards — poses, videos, and temporal annotations, with windowing and target encoding built in.

Installation

You can simply install it in your Python environment:

pip install sign-language-data-loading

The package is imported as sldl (see examples).

Some features need extra dependencies. Typically, data-loaders and custom targets need PyTorch. If you load the videos too, torchcodec is required. You can install them along with:

# For SignLanguageCollator and the built-in target encoders (sldl.targets.*)
pip install "sign-language-data-loading[torch]"

# For on-the-fly video loading (load_videos=True)
pip install "sign-language-data-loading[video]"

However, we do recommend setting them up yourself in your environment before installing sign-language-data-loading.

Quickstart

Load an isolated-sign dataset

from sldl import SignLanguageDataset
from sldl.configs import LSFBIsolConfig

dataset = SignLanguageDataset.from_config(
    LSFBIsolConfig(
        root="path/to/lsfb-isol",
        variant="500",
        split="training",
    )
)

sample = dataset[0]
print(sample["label"])          # e.g. "bonjour"
print(sample["poses"]["upper_pose"].shape)

Load a continuous dataset

from sldl import SignLanguageDataset
from sldl.configs import LSFBContConfig

dataset = SignLanguageDataset.from_config(
    LSFBContConfig(
        root="path/to/lsfb-cont",
        split="training",
    )
)

sample = dataset[0]
print(sample["annotations"]["both_hands"].head())

Batch samples for training

from torch.utils.data import DataLoader
from sldl import SignLanguageCollator

loader = DataLoader(dataset, batch_size=8, collate_fn=SignLanguageCollator())
batch = next(iter(loader))
print(batch["poses"]["upper_pose"].shape)   # (batch, max_n_frames, ...)
print(batch["masks"].shape)                 # (batch, max_n_frames)

Going further

• Custom dataset paths, windowing, and target encoders: see SignLanguageDataset and sldl.targets.
• Full worked examples (loading, visualizing poses/video, windowing, target encoding) are in examples/.

Related projects

• sign-language-tools (PyPI) — pose and annotation transforms (e.g. SegmentsToFrameLabels, SegmentsToBoundaryOffsets) used by some of the built-in target encoders (sldl.targets.FrameLabelsTarget, sldl.targets.TemporalBoundaryOffsetsTarget).
• lsfb-cont dataset — French-Belgian Sign Language (LSFB) dataset, available on HuggingFace. It is very useful for Sign Language Processing tasks that requires a Continuous Sign Language Dataset, such as Continuous Sign Language Recognition (CSLR) and Sign Language Segmentation (SLS).
• lsfb-isol dataset — Isolated version, i.e. ONE sign per video, of the LSFB dataset. Very useful for Isolated Sign Language Recognition (ISLR).