Batch and Stream mode

Celantur Container batch and stream mode allow you to anonymize images and videos stored on the local file system.
How to use Celantur Container video

Preparation

The following folders are necessary:
$ROOT
├── input/
├── licensing/
├── log/
└── output/
  • input: Where the original files are stored(including subfolders)
    • For images, following formats are supported: .jpg / .jpeg, .png, .tif / .tiff, .bmp and .jfif.
    • For videos, following formats are supported: .mpeg, .mp4 and .avi.
  • output: Folder for the anonymized images/videos. If a file exists with the same as in input folder, then processing of the file is skipped.
  • log: Folder containing the logs.
  • licencing: Folder containing the license key. Copy the license file license into this folder as licensing/license.
You will be provided the script files mentioned below by the Celantur team.

Starting in Batch mode

Starting the Container in Batch mode triggers a processing of all files in the input folder. After files have been processed, the Container is shut down.
./celantur.sh -a face -a license-plate -f whole

Starting in Stream mode

Stream mode keeps the Container continuously checking the input folder for new files that have to be processed. The delay between checks can be specified in seconds. The Container needs to be shut down manually.
./celantur.sh --stream 5 -a face -a license-plate -f whole

Image and video processing

By default, Celantur Container processes images. Video processing has to be specified by adding the --video parameter.
Images: ./celantur.sh -a face -a license-plate -f whole
Videos: ./celantur.sh--video 5 -a face -a license-plate -f whole

Parameters

You can edit ./celantur.sh <parameters> to modify the behavior of Celantur Container. Experienced Linux user can modify the script celantur.sh
Parameter
Description
--anonymise {face, license-plate, person, vehicle} -a {face, license-plate, person, vehicle}
REQUIRED
Specify objects to be anonymized.
--format FORMAT -f FORMAT
REQUIRED
Specify image format. For normal camera images, use whole. For other formats, check usage with ./celantur.sh -h and the Image Format section.
--help -h
Prints help message with all parameters and exits.
--bbox
Anonymizes objects with bounding boxes
--debug
Enables debug mode. Bounding boxes of detected objects are displayed on images.
--score
Prints the certainty scores of detected objects on images, if debug mode is enabled.
--cpu-mode
Disables GPU utilization. See Using CPU only
--method {blur, pixelate, blacken, detect}
Choose anonymization method (default: blur)
--metrics <filename.json>
File name for metrics (default: metrics.json)
--quality [1..100]
Quality of output (JPEG) image (default: 90)
--overwrite
Overwrite existing files in output folder.
--stream [seconds]
Streaming mode (Wait time in seconds).
--server <host:port>
--server-array <host:port>
--video
Anonymize videos.
--person-threshold [0..1]
Threshold for whole person detection.
--vehicle-threshold [0..1]
Threshold for vehicle detection.
--face-threshold [0..1]
Threshold for face detection.
--license-plate-threshold [0..1]
Threshold for license plate detection.
--save-mask {all, instance, binary}
Generate binary and instance segmentation mask files per processed images. See Segmentation Masks.
--mask-scale {0..100}
Scales binary and instance segmentation mask files down by the specified ratio. See Segmentation Masks.
For more arguments, check ./celantur.sh --help.

Image format

Celantur Container is optimized to work on different image resolutions.
You can use the option --format to choose the resolution of the input images, eg. --format pano:8000 for an image resolution of 8000x4000. Use --format whole for all formats not listed below, or if the input images have different resolutions.
Parameter
Resolution
pano:4096
4096x2048
pano:5400
5400x2700
pano:5640
5640x2816
pano:7060
7060x3530
pano:7680
7680x3840
pano:8000
8000x4000
pano:7680
7680x3840
pano:8000
8000x4000
pano:8192
8192x4096
pano:11000
11000x5500
whole
default, valid for all resolutions