Glossary#
- event
One detector readout, stored as a variable number of points.
- point
One row of an event: a position plus its features and labels.
coordPoint positions, shape (N, 3) for 3D readers. Their frame and units come from the dataset and the transforms.
grid_coordInteger grid cells derived from
coordby grid sampling. Sparse-convolution and serialized-attention models read them.featModel input features, shape (N, C), in the order of
Collect’sfeat_keys.- packed batch
Several events concatenated along the point dimension instead of padded.
offsetThe cumulative end index of each event in a packed batch;
offset[-1]is the total number of points.- revision
A version of a dataset, such as PILArNet-M
v3, or of a Hugging Face repository.- semantic class
A per-point label such as shower or track (
segment_motifin PILArNet-M).- PID
Particle identity, such as muon or proton (
segment_pidin PILArNet-M).- instance
The points of one particle or one interaction. Instance ids are unique within an event.
- backbone
The encoder that turns a point cloud into per-point features.
- head
The task-specific layers on top of a backbone.
- pretraining
Training on unlabeled data, such as Panda’s self-distillation or PoLAr-MAE’s masked point modeling.
- fine-tuning
Training a pretrained model on a labeled task. In recipe names,
fftmeans full fine-tuning,decthe decoder and head, andlinthe head only.- warm start
Loading weights into a new run, with a new optimizer and step count (
--train.weight).- resume
Continuing a run from its checkpoint, including optimizer, step and data-loader state (
--train.resume).- registry
A mapping from a name in a config’s
typefield to a Python class.- experiment config
Python under
configs/that says what to train.- site profile
YAML under
launch/sites/that says where and how to run.- global batch size
Events per optimizer step, summed over all GPUs. pimm’s
batch_sizeis global.- rank
One training process, normally one per GPU.
- DDP
PyTorch DistributedDataParallel, pimm’s default for more than one GPU.
- export
A portable model directory with weights and a config, made by
pimm export.