TCP mode

You can run Celantur Container in TCP mode. This allows you to send and receive images (in JPEG format or as NumPy array) over a TCP socket connection, resulting in performance gains by reducing read/write and data conversion overhead.

Not yet supported in TCP mode

• Anonymization of video files

• Generation of metadata JSON files

Parameters

Parameter	Description
--server <host:port>	TCP mode for JPEG image transfer.
--server-array <host:port>	TCP mode for NumPy array transfer.

Transfer images as JPEG

Transfer images in JPEG format over a TCP connection by using

Blur faces/license plates

bash celantur.sh --server 0.0.0.0:9999 -a face -a license-plate --format whole

Find a Python implementation of the client script here:

celantur-examples/server/celantur-jpeg-client.py at main · celantur/celantur-examplesGitHub

Implementation

Transfer images as NumPy arrays

Transfer images as NumPy arrays over a TCP connection by using

bash celantur.sh --server-array 0.0.0.0:9999 -a face -a license-plate --format whole

Add save-mask binary --mask-scale 20 as parameters to receive segmentation masks instead of an anonymized image. The received binary mask has to be saved as PNG.

Get binary masks

bash celantur.sh --server-array 0.0.0.0:9999 -a face -a license-plate --format whole --save-mask binary --mask-scale 20

Find a Python implementation of the client script here:

celantur-examples/server/celantur-numpy-client.py at main · celantur/celantur-examplesGitHub

Implementation

FAQ

I'm transferring data over a VPN, does that work?

Yes, transferring data via TCP mode over a VPN works.

The maximum TCP frame size has to be lower than the one specified for your VPN, to avoid issues during data transfer.