The Visual ChangeNet-Segmentation Model (ChangeSim) detects changes in industrial indoor environment (warehouse) from a pair of co-registered warehouse images. This model is ready for commercial use.
Architecture Type: Transformer-Based
Network Architecture: Siamese Network
Visual ChangeNet is a state of the art transformer-based change detection model. Visual ChangeNet is based on Siamese Network, which is a class of neural network architectures containing two or more identical subnetworks. The training algorithm works by updating the parameters across all the sub-networks in tandem. In TAO, Visual ChangeNet supports two images as input where the end goal is to classify or segment the change between the "golden or reference" image and the "test" image. More specifically, this model was trained with the NV DINOv2 backbone, which was trained in a self-supervised manner on NVIDIA proprietary data and achieved SOTA accuracy on zero-shot ImageNet classification. To enable the ViT backbone in Visual ChangeNet, the ViT-Adapter was used as the neck architecture. The ViT-Adapter improves the accuracy on dense predictions, such as object detection and segmentation. In TAO, two different types of change detection networks are supported:
Visual ChangeNet-Segmentation is specifically intended for change segmentation. In this model card, the Visual ChangeNet-Segmentation model is leveraged to demonstrate warehouse change detection using ChangeSim dataset for indoor warehouse change detection. The model uses a pretrained NV DINOv2 backbone, trained on the NVIDIA-commercial dataset, and then fine-tuned on the ChangeSim dataset.
Input Type(s): Images
Input Format(s): Red, Green, Blue (RGB)
Input Parameters: Three-Dimensional (3D)
Other Properties Related to Input:
Two input images:
Channel Ordering of the Input: NCHW, where N = Batch Size, C = number of channels (3), H = Height of images (512), W = Width of the images (512)
Here is a sample image for a pre and post change images along with ground-truth segmentation change map side-by-side.
Output Type(s): Segmentation Change Map
Output Format: 3D Vector
Other Properties Related to Output:
Segmentation change map with the same resolution as the input images: 512 X 512 X 5 (H x W x C), where C = number of output change classes.
Runtime Engine(s):
Supported Hardware Architecture(s):
Supported Operating System(s):
This model was trained using the visual_changenet
entrypoint in TAO. The training algorithm optimizes the network to minimize the cross-entropy loss for every pixel of the mask.
These models need to be used with NVIDIA hardware and software. For hardware, the models can run on any NVIDIA GPU including NVIDIA Jetson devices. These models can only be used with the Train Adapt Optimize (TAO) Toolkit, or TensorRT.
The primary use case for these models is for Visual ChangeNet-Segmentation using RGB images. The model is a Siamese Network that outputs semantic change maps denoting pixel-level change between the two images.
These models are intended for training and fine-tuning using the TAO Toolkit and your datasets for image comparison. High-fidelity models can be trained on new use cases. A Jupyter Notebook is available as a part of the TAO container and can be used to re-training.
The models are also intended for edge deployment using TensorRT.
To use these models as pretrained weights for transfer learning, use the following as a template for the model
and train
component of the experiment spec file to train a Siamese Network model. For more information on the experiment spec file, see the TAO Toolkit User Guide - Visual ChangeNet-Segmentation.
model:
backbone:
type: "vit_large_nvdinov2"
pretrained_backbone_path: null
freeze_backbone: False
Data Collection Method by dataset:
Labeling Method by dataset:
Properties:
Open-source ChangeSim dataset collected in photo-realistic simulation environments with the presence of environmental non-targeted variations, such as air turbidity and light condition changes, as well as targeted object changes in industrial indoor environments. It is an indoor warehouse CD dataset that contains pre and post change image pairs of resolution 640 × 480 (W x H). We resize these images to size 512 × 512. The dataset is split into two parts to make training and evaluation sets of samples 13,225 and 8,212 respectively.
Dataset | No. of Images |
---|---|
ChangeSim | 21,437 |
Data Collection Method by dataset:
Labeling Method by dataset:
Properties:
Open-source ChangeSim warehouse change detection dataset of 8,212 images.
The performance of the Visual ChangeNet-Segmentation model for multi-class semantic change detection is measured using overall accuracy, average precision, average recall, and avergae IoU score for all the classes.
Model | Model Architecture | Testing Images | Precision | Recall | IoU | F1 | Overall Accuracy |
---|---|---|---|---|---|---|---|
Visual ChangeNet-Segmentation | Siamese Network | 8212 | 57 | 45 | 36.5 | 48.1 | 92.83 |
To compare with the metrics reported by ChangeSim, here are the IoU scores for individual change classes for the above model:
Model | Model Architecture | Testing Images | M | N | Re | Ro | S | mIoU |
---|---|---|---|---|---|---|---|---|
Visual ChangeNet-Segmentation | Siamese Network | 8212 | 16 | 19.76 | 19.64 | 33.6 | 93.5 | 36.5 |
Here M, N, Re, Ro and S represent the IoU score for the 5 classes in ChangeSim change detection (Missing, New, Replaced, Rotated, Static).
Engine: Tensor(RT)
Test Hardware:
The inference is run on the provided unpruned model at FP16 precision. The inference performance is run using trtexec
on Jetson AGX Xavier, Xavier NX, Orin, Orin NX and NVIDIA T4, and Ampere GPUs. The Jetson devices are running at Max-N configuration for maximum GPU frequency. The performance shown here is the inference only performance. The end-to-end performance with streaming video data might vary depending on other bottlenecks in the hardware and software.
NVDINOv2 + ViT-Adapter + Visual ChangeNet
Platform | BS | FPS |
---|---|---|
Orin NX 16GB | 16 | 1.5 |
AGX Orin 64GB | 16 | 9.41 |
A2 | 8 | 5.9 |
T4 | 16 | 2.29 |
L4 | 16 | 4.68 |
A30 | 16 | 35.8 |
L40 | 16 | 11.3 |
A100 | 32 | 10.8 |
H100 | 32 | 23.5 |
The Visual ChangeNet-Segmentation network model was trained on pairwise indoor warehouse imagery and might not perform well for misaligned image pairs not intended for warehouse scene change detection.
The license to use the model is covered by the Model EULA. By downloading the unpruned or pruned version of the model, you accept the terms and conditions of these licenses.
NVIDIA believes Trustworthy AI is a shared responsibility and we have established policies and practices to enable development for a wide array of AI applications. When downloaded or used in accordance with our terms of service, developers should work with their internal model team to ensure this model meets requirements for the relevant industry and use case and addresses unforeseen product misuse. For more detailed information on ethical considerations for this model, please see the Model Card++ Promise and the Explainability, Bias, Safety & Security, and Privacy Subcards.