L2BTTrain
Python template · sinapsis_anomalib.templates.anomalib_train
Overview
Training implementation for Anomalib models.
L2BT — inherited documentation
Learning to Be a Transformer algorithm.
The L2BT model consists of a pre-trained Vision Transformer teacher that extracts patch embeddings and two shallow student MLPs (backward_net and forward_net) that learn to match the teacher's patch embeddings. The model detects anomalies by comparing the student's ability to reconstruct teacher embeddings on normal images, where degradation indicates anomalies.
Args: lr (float): Learning rate for student network optimization. Defaults to ``1e-4``. layers (Sequence[int]): Indices of Vision Transformer layers used for feature extraction. Must be a sequence of exactly two indices. Defaults to ``(7, 11)``. blur_w_l (int): Lower bound for blur kernel width in augmentation. Defaults to ``5``. blur_w_u (int): Upper bound for blur kernel width in augmentation. Defaults to ``7``. blur_pad_l (int): Lower bound for blur padding in augmentation. Defaults to ``2``. blur_pad_u (int): Upper bound for blur padding in augmentation. Defaults to ``3``. blur_repeats_l (int): Number of repetitions for lower blur kernel. Defaults to ``3``. blur_repeats_u (int): Number of repetitions for upper blur kernel. Defaults to ``5``. topk_ratio (float): Fraction of highest anomaly-map values to use for image-level anomaly scoring. Defaults to ``0.001``. pre_processor (PreProcessor | bool, optional): Pre-processor to transform input data before passing to model. If ``True``, uses default. Defaults to ``True``. post_processor (PostProcessor | bool, optional): Post-processor to generate predictions from model outputs. If ``True``, uses default. Defaults to ``True``. evaluator (Evaluator | bool, optional): Evaluator to compute metrics. If ``True``, uses default. Defaults to ``True``. visualizer (Visualizer | bool, optional): Visualizer to display results. If ``True``, uses default. Defaults to ``True``.
Example: >>> from anomalib.models.image import L2BT >>> from anomalib.data import MVTecAD >>> from anomalib.engine import Engine >>> datamodule = MVTecAD() >>> model = L2BT( ... layers=(7, 11), ... topk_ratio=0.001 ... ) >>> engine = Engine(model=model, datamodule=datamodule) >>> engine.fit() # doctest: +SKIP >>> predictions = engine.predict() # doctest: +SKIP
See Also: - :class:`anomalib.models.image.l2bt.torch_model.L2BTModel`: PyTorch implementation of the model architecture
Capabilities
Capabilities: not setInstallation
Install the published package using pip or uv.
pip install sinapsis-anomalib==1.0.0uv pip install sinapsis-anomalib==1.0.0uv add sinapsis-anomalib==1.0.0Configuration
Effective fields from the inspector schema, including nested Pydantic model fields.
Optional
Default: null
Optional
Default: null
Optional
Default: null
Path to checkpoint for resuming training. If None, starts training from scratch.
Optional
Default: null
Required
Default: null
Optional
Default: 0.0001
Optional
Default: [7,11]
Optional
Default: 5
Optional
Default: 7
Optional
Default: true
Optional
Default: 2
Optional
Default: 3
Optional
Default: 0.001
Optional
Default: true
Optional
Default: true
Optional
Default: 5
Optional
Default: 3
Optional
Default: true
Optional
Default: null
Optional
Default: null
(TrainerConfig): General trainer arguments. For more details see: https://lightning.ai/docs/pytorch/stable/common/trainer.html#trainer-flags l2bt_init lr <class 'float'>: default: 0.0001 layers typing.Sequence[int]:… Read full field description
(TrainerConfig): General trainer arguments. For more details see: https://lightning.ai/docs/pytorch/stable/common/trainer.html#trainer-flags l2bt_init lr <class 'float'>: default: 0.0001 layers typing.Sequence[int]: default: (7, 11) blur_w_l <class 'int'>: default: 5 blur_w_u <class 'int'>: default: 7 blur_pad_l <class 'int'>: default: 2 blur_pad_u <class 'int'>: default: 3 blur_repeats_l <class 'int'>: default: 5 blur_repeats_u <class 'int'>: default: 3 topk_ratio <class 'float'>: default: 0.001 pre_processor typing.Any: default: True post_processor typing.Any: default: True evaluator typing.Any: default: True visualizer typing.Any: default: True
Optional
Default: null
The devices to use for training (e.g., 1, [0, 1], "auto"). Defaults to "auto".
Optional
Default: "auto"
The maximum number of epochs to train for. Defaults to 5.
Optional
Default: 5
The minimum number of epochs to train for. Defaults to 1.
Optional
Default: 1
The hardware accelerator to use. Defaults to "auto".
Optional
Default: "cpu"
Optional
Default: null
Optional
Default: null
Optional
Default: null
Optional
Default: null
Optional
Default: null
Optional
Default: null
A descriptive name for the dataset.
Required
Default: null
The root directory where the dataset is located.
Optional
Default: null
A random seed for reproducibility in data splitting.
Optional
Default: null
Optional
Default: null
Optional
Default: null
Path to the directory containing normal images.
Required
Default: null
The number of subprocesses to use for data loading. Defaults to 8.
Optional
Default: 8
Path to the directory for abnormal images.
Optional
Default: null
Optional
Default: "from_test"
The number of samples per batch for evaluation. Defaults to 32.
Optional
Default: 32
Optional
Default: null
Optional
Default: "from_dir"
Optional
Default: 0.5
Optional
Default: 0.2
The number of samples per batch for training. Defaults to 32.
Optional
Default: 32
Optional
Default: 0.2
Configuration example
Generated from documented defaults. Replace any placeholders and complete required nested settings before running.
templates:
- template_name: "L2BTTrain"
class_name: "L2BTTrain"
attributes:
logger: null
callbacks: null
ckpt_path: null
l2bt_init:
lr: 0.0001
layers: [7, 11]
blur_w_l: 5
blur_w_u: 7
evaluator: true
blur_pad_l: 2
blur_pad_u: 3
topk_ratio: 0.001
visualizer: true
pre_processor: true
blur_repeats_l: 5
blur_repeats_u: 3
post_processor: true
threshold: null
train_root: null
trainer_args:
devices: "auto"
max_epochs: 5
min_epochs: 1
accelerator: "cpu"
image_metrics: null
normalization: null
pixel_metrics: null
logger_configs: null
callback_configs: null
folder_attributes:
name: "<required>"
root: null
seed: null
mask_dir: null
extensions: null
normal_dir: "<required>"
num_workers: 8
abnormal_dir: null
val_split_mode: "from_test"
eval_batch_size: 32
normal_test_dir: null
test_split_mode: "from_dir"
val_split_ratio: 0.5
test_split_ratio: 0.2
train_batch_size: 32
normal_split_ratio: 0.2
View original docstring example
The source example references CfaTrain, not L2BTTrain.
agent:
name: my_test_agent
templates:
- template_name: InputTemplate
class_name: InputTemplate
attributes: {}
- template_name: CfaTrain
class_name: CfaTrain
template_input: InputTemplate
attributes:
folder_attributes_config_path: 'path/to/config.yaml'
generic_key: 'my_generic_key'
callbacks: null
normalization: null
threshold: null
image_metrics: null
pixel_metrics: null
logger: null
callback_configs: null
logger_configs: null
ckpt_path: null
trainer_args:
devices: "0"
accelerator: gpu
max_epochs: null
cfa_init:
backbone: wide_resnet50_2
gamma_c: 1
gamma_d: 1
num_nearest_neighbors: 3
num_hard_negative_features: 3
radius: 1.0e-05
For a full list of options use the sinapsis cli: sinapsis info --all-template-names.
If you want to see all available models, please visit:
https://anomalib.readthedocs.io/en/v1.2.0/markdown/guides/reference/models/image/index.html.Inheritance
sinapsis_anomalib.templates.anomalib_train.AnomalibTrainEnvironment variables
Environment definitions belong to their canonical Python modules.