> For the complete documentation index, see [llms.txt](https://doc.celantur.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://doc.celantur.com/container/usage/recommended-parameters.md).

# Recommended Parameters

A list of recommended parameters for different camera systems to achieve best anonymization results with Celantur Container.

Go to: [#dji](#dji "mention") [#insta360](#insta360 "mention") [#ladybug](#ladybug "mention") [#mosaic](#mosaic "mention")

{% hint style="success" %}
When starting with a demo of Celantur Container, our team will send you a customised code sample.
{% endhint %}

## Anonymise Mobile Mapping Images

Due to large resolution, panorama images require special parametrisation to achieve the best anonymisation results.

If the panorama's resolution exactly matches an item in the list of [Predefined Formats](/container/usage/batch-and-stream-mode.md#predefined-formats) (e.g. `pano:8192`), you can use it as `--format` argument:

{% code overflow="wrap" %}

```bash
./celantur.sh -a face  -a license-plate --format pano:8192
```

{% endcode %}

If your panorama's resolution is not part of [Predefined Formats](/container/usage/batch-and-stream-mode.md#predefined-formats), you can specify [Custom Tiling](/container/usage/general-parameters.md#custom-tiling):

<pre class="language-bash" data-overflow="wrap"><code class="lang-bash"><strong>./celantur.sh -a face -a license-plate \
</strong>  --format '{"number":[4,1],"overlap":[300,0],"section":[0,1870,12288,4950]}'
</code></pre>

{% hint style="info" %}
For best anonymization results, tiles should roughly be square.
{% endhint %}

### Mosaic

#### Mosaic X

Panorama images (13504x6752, 91.2 MP)

{% code overflow="wrap" %}

```bash
./celantur.sh -a face -a license-plate --face-threshold 0.1 --license-plate-threshold 0.1 \
  -f '{"number":[5,1],"overlap":[400,0],"section":[0,2200,13504,5300]}'
```

{% endcode %}

{% hint style="info" %}
Adapt thresholds (lower = better detections, potentially more false positives; higher = less false positives).
{% endhint %}

#### Mosaic 51

Panorama images (12288x6144, 75.5 MP)

```sh
./celantur.sh -a face -a license-plate --face-threshold 0.1 --license-plate-threshold 0.1 \
  -f '{"number":[4,1],"overlap":[200,0],"section":[0,1870,12288,4950]}'
```

### Insta360

#### Insta360 X4

Panorama images (11904x5952):

{% code overflow="wrap" %}

```bash
./celantur.sh \
  -a face \
  -a license-plate \
  --model segmentatio-omnium \
  -f '{"number":[4,1],"overlap":[200,0],"section":[0,2000,11904,4900]}' 
```

{% endcode %}

### GoPro

#### GoPro MAX

Panorama images (5760x2880)

{% code overflow="wrap" %}

```bash
./celantur.sh -a face -a license-plate \
  -f '{"number":[4,1],"overlap":[100,0],"section":[0,1000,5760,2340]}'
  
```

{% endcode %}

### Ladybug

#### Ladybug 5+

Panorama images (8000x4000)

<pre class="language-bash" data-title="Batch mode, face / license-plate" data-overflow="wrap"><code class="lang-bash"><strong>./celantur.sh -a face -a license-plate -f pano:8000 
</strong></code></pre>

#### Ladybug 6

Panorama images (12288x6144)

{% code title="Batch mode, face / license-plate" overflow="wrap" %}

```bash
./celantur.sh -a face -a license-plate --quality 85 \
  -f '{"number":[4,1],"overlap":[300,0],"section":[0,1870,12288,4950]}'
```

{% endcode %}

Planar images (2992x4096)

{% code overflow="wrap" %}

```bash
./celantur.sh -a face -a license-plate --license-plate-threshold 0.1 \
  -f '{"number":[2,1],"overlap":[750,0],"section":[0,1500,2992,4096]}'
```

{% endcode %}

Comment to planar images: Upper part of image is ignored.

### NCTech

#### iStar Pulsar

Panorama images (11000x5500)

{% code overflow="wrap" %}

```bash
./celantur.sh -a face --face-threshold 0.1  -a license-plate --license-plate-threshold 0.1 \ 
  -f pano:11000
```

{% endcode %}

### Smart Delta

#### SmartPano Gen2

Panorama images (7680x3840)

{% code overflow="wrap" %}

```bash
./celantur.sh -a face --face-threshold 0.1 -a license-plate --license-plate-threshold 0.1 \
  -f '{"number":[4,1],"overlap":[200,0],"section":[0,1200,7680,2900]}'
```

{% endcode %}

{% code overflow="wrap" %}

```bash
./celantur.sh -a person -a vehicle -f '{"number":[4,1],"overlap":[200,0],"section":[0,1200,7680,2900]}'
```

{% endcode %}

### Ricoh

#### Ricoh Theta Z1

Fisheye images.

{% code overflow="wrap" %}

```bash
./celantur.sh -a face --face-threshold 0.4 -a person \
  -a license-plate --license-plate-threshold 0.2 \ 
  -f '{"number":[3,3],"overlap":[150,150]}' \
  --quality 80
```

{% endcode %}

The images might be rotated. To increase the accuracy of object detection, it is recommended to rotate the images before processing. You can do this with [ImageMagick](https://imagemagick.org/#gsc.tab=0):

```bash
# In-place rotation. The images will be overwritten with their rotated version.
# Before anonymisation: Rotate "upright"
mogrify -rotate -90 ./**/*front.jpg
mogrify -rotate 90 ./**/*back.jpg

# After anonymisation: Rotate "to original state"
mogrify -rotate 90 ./**/*front.jpg
mogrify -rotate -90 ./**/*back.jpg
```

### AVT

#### Prosilica GT4500

Planar images (5472x3084)

{% code overflow="wrap" %}

```bash
./celantur.sh -a face -a license-plate --license-plate-threshold 0.1 \
  -f '{"number":[2,1],"overlap":[750,0],"section":[0,1000,5328,4608]}'
```

{% endcode %}

Comment: Upper part of image is ignored.

## Anonymize Drone Images

For best anonymization results, the whole drone image should be split into roughly square tiles each of which is ca 4 to 10 times larger than the objects to be blurred, and with a general overlap.

More information in [General Parameters](/container/usage/general-parameters.md#custom-tiling)

```bash
./celantur.sh -a person --person-threshold 0.3 \
  -a vehicle --vehicle-threshold 0.4 \
  -f '{"number":[4,3],"overlap":[200,200]}'
```

#### DJI Mini 3 Pro

Images (4032x3024).

Persons and vehicles

{% code overflow="wrap" %}

```bash
./celantur.sh -a person --person-threshold 0.3 \
  -a vehicle --vehicle-threshold 0.4 \
  -f '{"number":[4,3],"overlap":[200,200]}'
```

{% endcode %}

Faces and license plates

{% code overflow="wrap" %}

```bash
./celantur.sh -a face --face-threshold 0.1 \
  -a license-plate --license-plate-threshold 0.1 \ 
  -f '{"number":[4,3],"overlap":[200,200]}'
```

{% endcode %}

## Anonymize FullHD Videos

{% hint style="success" %}
Check if your video's [codec](https://doc.celantur.com/container/usage/batch-and-stream-mode#supported-video-codecs) is supported.
{% endhint %}

{% code overflow="wrap" %}

```bash
./celantur.sh -a face -a license-plate --video --keep-bit-rate
```

{% endcode %}

### FullHD Dashcam Frames

{% code overflow="wrap" %}

```bash
./celantur.sh -a face -a license-plate
```

{% endcode %}
