citic-mtmc-dataset

An indoors multi-camera video dataset for person tracking.

https://github.com/gtec-udc/citic-mtmc-dataset

Science Score: 67.0%

This score indicates how likely this project is to be science-related based on various indicators:

  • CITATION.cff file
    Found CITATION.cff file
  • codemeta.json file
    Found codemeta.json file
  • .zenodo.json file
    Found .zenodo.json file
  • DOI references
    Found 6 DOI reference(s) in README
  • Academic publication links
    Links to: sciencedirect.com
  • Academic email domains
  • Institutional organization owner
  • JOSS paper metadata
  • Scientific vocabulary similarity
    Low similarity (8.6%) to scientific vocabulary
Last synced: 6 months ago · JSON representation ·

Repository

An indoors multi-camera video dataset for person tracking.

Basic Info
  • Host: GitHub
  • Owner: GTEC-UDC
  • License: mit
  • Language: Python
  • Default Branch: master
  • Size: 626 KB
Statistics
  • Stars: 2
  • Watchers: 2
  • Forks: 1
  • Open Issues: 0
  • Releases: 0
Created about 3 years ago · Last pushed over 2 years ago
Metadata Files
Readme Citation

Readme.md

CITIC-MTMC dataset

This repository contains the CITIC-MTMC dataset. A multi-target multi-camera video dataset for indoor location and tracking of people.

The recordings were carried out inside the CITIC research center. Five cameras were deployed in four spaces of the building: an entrance hall with two cameras (HallWide, HallSeg), two passageways with one camera each (PF and PC), and a showroom with one camera (Showroom).

Ground-truth obtention

A system based on discrete waypoints was established to obtain the ground-truth positions of each person during the capture. These waypoints were graphic marks placed on the building floor at predetermined and known positions. Each person carries a smartphone with an application that sends a notification to a server when the person is just above one of these waypoints.

The mobile application also integrates a BLE beacon scanner. This scanner detects the signal level (RSS) and the identifiers (UUID, major, and minor of the iBeacon format) of each nearby BLE beacon. This data is sent to the server continuously, adding a timestamp to each message. This optional feature allows to assess the BLE location accuracy against other technologies, or to improve the tracking results by using this additional information.

The source code of the server and the mobile application is available at the following repositories:

Hardware setup

The camera model, resolution, and maximum FPS used to record the video streams are:

  • PF and PC: ieGeek IG20. 1920x1080. 12.5 FPS.
  • Showroom and HallWide: Dahua DH-SD22204T-GN. 1280x720. 10 FPS.
  • HallSeg: AXIS M5525-E. 720x576. 25 FPS.

The camera recordings were processed to have a fixed frame-rate of 25 FPS. This was necessary because the cameras stored the video streams with a variable frame-rate, reducing the frame-rate when no motion was detected to improve the compression rate. Lens distortion was also corrected using the Defish0r plugin to remove the fisheye lens effect.

In addition to the camera setup, we also deployed eight BLE beacons to measure the proximity of individuals to them. Specifically, we used the Sevenix Postrum TWF535-BR2 beacons, which utilize the Panasonic PAN1721 BLE module. Three different smartphones were used to measure the RSS from the BLE beacons: an iPhone 11 Pro, a Google Pixel 4, and a POCO F3.

Provided files

The video recordings are located in capture1, capture2, and capture3 directories.

The mapconfig directory contains the CITIC floor plan in SVG (Inkscape file) and PDF: citicmap.svg and citicmap.pdf. The roommap.json file contains the simplified map with rooms and doors used by our tracker. The Node*.json files contain the information about every camera: position and calibration parameters.

The ground-truth positions are in the capture*_gt.mot.txt files. The files follow the MOT15 CSV format:

<frame>, <id>, <bb_left>, <bb_top>, <bb_width>, <bb_height>, <conf>, <x>, <y>, <z>

The BLE information is in the BLE directory:

  • anchorsensorscitic.json : The BLE beacons positions.
  • beaconreports.json : The complete beacon reports during all the dataset capture process.
  • capture*beaconscans.json: The obtained beacon reports for each of the captured sequences.

The ground-truth position files and the beacon report files can be generated by the generate_gt.py script using the following files: paths.csv, timesyncs.csv, and BLE/beaconreports.json.

Citation

Please cite our paper if you use this dataset or the ground-truth generation method.

Á. Carro-Lagoa, V. Barral, M. González-López, C. J. Escudero, and L. Castedo, "Multicamera edge-computing system for persons indoor location and tracking," Elsevier Internet of Things, vol. 24, no. 100940, pp. 1-15, Sep 2023. DOI: https://doi.org/10.1016/j.iot.2023.100940

@article{CARROLAGOA2023100940, title = {Multicamera edge-computing system for persons indoor location and tracking}, journal = {Internet of Things}, volume = {24}, pages = {100940}, year = {2023}, issn = {2542-6605}, doi = {https://doi.org/10.1016/j.iot.2023.100940}, url = {https://www.sciencedirect.com/science/article/pii/S2542660523002639}, author = {Ángel Carro-Lagoa and Valentín Barral and Miguel González-López and Carlos J. Escudero and Luis Castedo} }

License

The CITIC-MTMC dataset is licensed under the CC BY-NC-SA 4.0 license. The included source code is provided under the MIT license.

Owner

  • Name: Group of Electronic Technology and Communications
  • Login: GTEC-UDC
  • Kind: organization

GTEC is the acronym of Grupo de Tecnología Electrónica y Comunicaciones (GTEC), a research group of the University of A Coruña (UDC)

Citation (CITATION.cff)

cff-version: 1.2.0
message: "If you use this dataset, please cite the following paper."
title: "CITIC-MTMC dataset"
authors:
  - family-names: Carro-Lagoa
    given-names: Ángel
    orcid: "https://orcid.org/0000-0001-5513-7969"
  - family-names: Barral
    given-names: Valentín
    orcid: "https://orcid.org/0000-0001-8750-7960"
  - family-names: González-López
    given-names: Miguel
    orcid: "https://orcid.org/0000-0002-0197-1955"
  - family-names: Escudero
    given-names: Carlos J.
    orcid: "https://orcid.org/0000-0002-3877-1332"
  - family-names: Castedo
    given-names: Luis
    orcid: "https://orcid.org/0000-0002-3801-012X"
url: https://github.com/GTEC-UDC/citic-mtmc-dataset
license: CC-BY-NC-SA-4.0
preferred-citation:
  type: article
  title: "Multicamera edge-computing system for persons indoor location and tracking"
  authors:
  - family-names: Carro-Lagoa
    given-names: Ángel
    orcid: "https://orcid.org/0000-0001-5513-7969"
  - family-names: Barral
    given-names: Valentín
    orcid: "https://orcid.org/0000-0001-8750-7960"
  - family-names: González-López
    given-names: Miguel
    orcid: "https://orcid.org/0000-0002-0197-1955"
  - family-names: Escudero
    given-names: Carlos J.
    orcid: "https://orcid.org/0000-0002-3877-1332"
  - family-names: Castedo
    given-names: Luis
    orcid: "https://orcid.org/0000-0002-3801-012X"
  doi: 10.1016/j.iot.2023.100940
  url: https://www.sciencedirect.com/science/article/pii/S2542660523002639
  journal: Internet of Things
  volume: 24
  pages: 100940
  year: 2023
  month: 9
  date-released: 2023-09-12
  issn: 2542-6605
  keywords:
  - Computer vision
  - Edge computing
  - Indoor localization
  - Data sets
  - Video annotation
  - Tracking
  - Privacy

GitHub Events

Total
  • Push event: 3
Last Year
  • Push event: 3