Sign inSign up

intel/tfcc

Verified Publisher

By Intel Corporation

•Updated 4 days ago

Sensor Fusion for Traffic Management

Image
0

10K+

intel/tfcc repository overview

⁠Sensor Fusion for Traffic Management

Github Repo⁠

⁠Install Docker Engine and Docker Compose on Ubuntu

Install Docker Engine⁠ and Docker Compose⁠ according to the guide on the official website.

Before you install Docker Engine for the first time on a new host machine, you need to set up the Docker apt repository. Afterward, you can install and update Docker from the repository.

  1. Set up Docker's apt repository.
# Add Docker's official GPG key:
sudo -E apt-get update
sudo -E apt-get install ca-certificates curl
sudo -E install -m 0755 -d /etc/apt/keyrings
sudo -E curl -fsSL https://download.docker.com/linux/ubuntu/gpg -o /etc/apt/keyrings/docker.asc
sudo chmod a+r /etc/apt/keyrings/docker.asc

# Add the repository to Apt sources:
echo \
  "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.asc] https://download.docker.com/linux/ubuntu \
  $(. /etc/os-release && echo "${UBUNTU_CODENAME:-$VERSION_CODENAME}") stable" | \
  sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
sudo -E apt-get update
  1. Install the Docker packages.

To install the latest version, run:

sudo -E apt-get install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin
  1. Set proxy(Optional).

Note you may need to set proxy for docker.

sudo mkdir -p /etc/systemd/system/docker.service.d
sudo vim /etc/systemd/system/docker.service.d/http-proxy.conf

# Modify the file contents as follows
[Service]
Environment="HTTP_PROXY=http://proxy.example.com:8080"
Environment="HTTPS_PROXY=http://proxy.example.com:8080"
Environment="NO_PROXY=localhost,127.0.0.1"

Then restart docker:

sudo systemctl daemon-reload
sudo systemctl restart docker
  1. Verify that the installation is successful by running the hello-world image:
sudo docker run hello-world

This command downloads a test image and runs it in a container. When the container runs, it prints a confirmation message and exits.

  1. Add user to group
sudo usermod -aG docker $USER
newgrp docker
  1. Then pull base image
docker pull ubuntu:24.04
⁠Install the corresponding driver on the host
bash install_driver_related_libs.sh

If driver are already installed on the machine, you don't need to do this step.

⁠Pull docker image through docker hub

You can pull latest tfcc docker image through intel/tfcc - Docker Image⁠.

For example:

docker pull intel/tfcc:latest
⁠Build and run docker image through scripts

Note that the default username is tfcc and password is intel in docker image.

⁠Build docker image

Usage:

bash build_docker.sh <IMAGE_TAG, default tfcc:latest> <DOCKERFILE, default Dockerfile_TFCC.dockerfile>  <BASE, default ubuntu> <BASE_VERSION, default 24.04>

Example:

cd $PROJ_DIR/docker
bash build_docker.sh tfcc:latest Dockerfile_TFCC.dockerfile
⁠Run docker image

Usage:

bash run_docker.sh <DOCKER_IMAGE, default tfcc:latest> <NPU_ON, default false>

Example:

cd $PROJ_DIR/docker
bash run_docker.sh tfcc:latest false
# After the run is complete, the container ID will be output, or you can view it through docker ps
⁠Enter docker

Get the container id by command bellow:

docker ps -a

And then enter docker by command bellow:

docker exec -it <container id> /bin/bash
⁠Copy dataset

If you want to copy dataset or other files to docker, you can refer the command bellow:

docker cp /path/to/dataset <container id>:/path/to/dataset
⁠Build and run docker image through docker compose

Note that the default username is tfcc and password is intel in docker image.

Modify proxy, VIDEO_GROUP_ID and RENDER_GROUP_ID in .env file.

# proxy settings
https_proxy=
http_proxy=
# base image settings
BASE=ubuntu
BASE_VERSION=24.04
# group IDs for various services
VIDEO_GROUP_ID=44
RENDER_GROUP_ID=110
# display settings
DISPLAY=$DISPLAY

You can get VIDEO_GROUP_ID and RENDER_GROUP_ID with the following command:

# VIDEO_GROUP_ID
echo $(getent group video | awk -F: '{printf "%s\n", $3}')
# RENDER_GROUP_ID
echo $(getent group render | awk -F: '{printf "%s\n", $3}')
⁠Build and run docker image

Uasge:

cd $PROJ_DIR/docker
docker compose up <services-name> -d # tfcc and tfcc-npu. tfcc-npu means with NPU support

Example:

cd $PROJ_DIR/docker
docker compose up tfcc -d

Note if you need NPU support, for example, on MTL platform please run the command bellow:

cd $PROJ_DIR/docker
docker compose up tfcc-npu -d
⁠Enter docker

Usage:

docker compose exec <services-name> /bin/bash

Example:

docker compose exec tfcc /bin/bash
⁠Copy dataset

Find the container name or ID:

docker compose ps

Sample output:

NAME                IMAGE      COMMAND       SERVICE    CREATED         STATUS         PORTS
docker-tfcc-1    tfcc:latest   "/bin/bash"     tfcc   4 minutes ago   Up 9 seconds

copy dataset

docker cp /path/to/dataset docker-tfcc-1:/path/to/dataset

Caution:

This container image is intended for demo purposes only and not intended for production use.

To receive expanded security maintenance from Canonical on the Ubuntu base layer, you may follow the how-to guide to enable Ubuntu Pro in a Dockerfile⁠, which will require the image to be rebuilt.

Tag summary

Content type

Image

Digest

sha256:774be2862…

Size

3.8 GB

Last updated

about 1 month ago

docker pull intel/tfcc

This week's pulls

Pulls:

45

Last week

Learn more⁠