Skip to main content

Perceiving Humans: from Monocular 3D Localization to Social Distancing / MonStereo: When Monocular and Stereo Meet at the Tail of 3D Human Localization

Project description

Perceiving Humans in 3D

This repository contains the code for two research projects:

  1. Perceiving Humans: from Monocular 3D Localization to Social Distancing (MonoLoco++)
    README & Article

    social distancing

    monoloco_pp

  2. MonStereo: When Monocular and Stereo Meet at the Tail of 3D Human Localization
    README & Article

    monstereo 1

Both projects has been built upon the CVPR'19 project Openpifpaf for 2D pose estimation and the ICCV'19 project MonoLoco for monocular 3D localization. All projects share the AGPL Licence.

Setup

Installation steps are the same for both projects.

Install

The installation has been tested on OSX and Linux operating systems, with Python 3.6 or Python 3.7. Packages have been installed with pip and virtual environments. For quick installation, do not clone this repository, and make sure there is no folder named monstereo in your current directory. A GPU is not required, yet highly recommended for real-time performances. MonStereo can be installed as a package, by:

pip3 install monstereo

For development of the monstereo source code itself, you need to clone this repository and then:

pip3 install sdist
cd monstereo
python3 setup.py sdist bdist_wheel
pip3 install -e .

Interfaces

All the commands are run through a main file called main.py using subparsers. To check all the commands for the parser and the subparsers (including openpifpaf ones) run:

  • python3 -m monstereo.run --help
  • python3 -m monstereo.run predict --help
  • python3 -m monstereo.run train --help
  • python3 -m monstereo.run eval --help
  • python3 -m monstereo.run prep --help

or check the file monstereo/run.py

Data structure

Data         
├── arrays                 
├── models
├── kitti
├── figures
├── logs

Run the following to create the folders:

mkdir data
cd data
mkdir arrays models kitti figures logs

Further instructions for prediction, preprocessing, training and evaluation can be found here:

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

monstereo-0.2.0.tar.gz (69.8 kB view details)

Uploaded Source

Built Distribution

monstereo-0.2.0-py3-none-any.whl (97.4 kB view details)

Uploaded Python 3

File details

Details for the file monstereo-0.2.0.tar.gz.

File metadata

  • Download URL: monstereo-0.2.0.tar.gz
  • Upload date:
  • Size: 69.8 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.3.0 pkginfo/1.6.1 requests/2.25.0 setuptools/50.3.2 requests-toolbelt/0.9.1 tqdm/4.55.1 CPython/3.7.8

File hashes

Hashes for monstereo-0.2.0.tar.gz
Algorithm Hash digest
SHA256 bc628a4534daaa939dfd18c092e5212782d78464b3bd8b23f7c12a09b10a9e9f
MD5 63ea1181655607829464c1cfd93751db
BLAKE2b-256 213cdbf8f3f20038017f12af7269c663839080cfe4fefbb02eb280931562cf12

See more details on using hashes here.

File details

Details for the file monstereo-0.2.0-py3-none-any.whl.

File metadata

  • Download URL: monstereo-0.2.0-py3-none-any.whl
  • Upload date:
  • Size: 97.4 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.3.0 pkginfo/1.6.1 requests/2.25.0 setuptools/50.3.2 requests-toolbelt/0.9.1 tqdm/4.55.1 CPython/3.7.8

File hashes

Hashes for monstereo-0.2.0-py3-none-any.whl
Algorithm Hash digest
SHA256 0290657fb03661f99b06a729fb4fd530180339fa93e1ee3dd7113011e88d9af1
MD5 972db2cc6d291c9538fed36383d7850a
BLAKE2b-256 30d01d13cda3e19970f070be96399252efc46877ed7cf8c0b31100c984e9645d

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page