Skip to main content

Python interface for H3DS dataset

Project description

H3DS Dataset

PyPI

This repository contains the code for using the H3DS dataset introduced in H3D-Net: Few-Shot High-Fidelity 3D Head Reconstruction

Access

The H3DS dataset is only available for non-commercial research purposes. To request access, please fill in the contact form with your academic email. Your application will be reviewed and, after acceptance, you will recieve a H3DS_ACCESS_TOKEN together with the license and terms of use.

Setup

The simplest way to use the H3DS dataset is by installing it as a pip package:

pip install h3ds

Using H3DS

You can start using H3DS in your project with a few lines of code

from h3ds.dataset import H3DS

h3ds = H3DS(path='local/path/to/h3ds')
h3ds.download(token=H3DS_ACCESS_TOKEN)
mesh, images, masks, cameras = h3ds.load_scene(scene_id='1b2a8613401e42a8')

To list the available scenes, simply use:

scenes = h3ds.scenes() # returns all the scenes ['1b2a8613401e42a8', ...]
scenes = h3ds.scenes(tags={'h3d-net'}) # returns the scenes used in H3D-Net paper

In order to reproduce the results from H3D-Net, we provide default views configurations for each scene:

views_configs = h3ds.default_views_configs(scene_id='1b2a8613401e42a8') # '3', '4', '8', '16' and '32'
mesh, images, masks, cameras = h3ds.load_scene(scene_id='1b2a8613401e42a8', views_config_id='3')

This will load a scene with a mesh, 3 images, 3 masks and 3 cameras.

Please, see the provided examples for more insights.

Terms of use

By using the H3DS Dataset you agree with the following terms:

  1. The data must be used for non-commercial research and/or education purposes only.
  2. You agree not to copy, sell, trade, or exploit the data for any commercial purposes.
  3. If you will be publishing any work using this dataset, please cite the original paper.

Citation

@article{ramon2021h3d,
  title={H3D-Net: Few-Shot High-Fidelity 3D Head Reconstruction},
  author={Ramon, Eduard and Triginer, Gil and Escur, Janna and Pumarola, Albert and Garcia, Jaime and Giro-i-Nieto, Xavier and Moreno-Noguer, Francesc},
  journal={arXiv preprint arXiv:2107.12512},
  year={2021}
}

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

h3ds-0.2.0.tar.gz (12.1 kB view details)

Uploaded Source

Built Distribution

h3ds-0.2.0-py3-none-any.whl (11.5 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: h3ds-0.2.0.tar.gz
  • Upload date:
  • Size: 12.1 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.4.2 importlib_metadata/4.8.1 pkginfo/1.7.1 requests/2.26.0 requests-toolbelt/0.9.1 tqdm/4.62.2 CPython/3.6.7

File hashes

Hashes for h3ds-0.2.0.tar.gz
Algorithm Hash digest
SHA256 ebea3e6fef372b706aa03dffd0cf4ba401824523f50bba1707e91a0c0d656e29
MD5 0db2773dcdd6043fa92452fbb0a79433
BLAKE2b-256 12c1b4b08f1f84dd37e08c117efa43d8412662b02d43c9189b38235103875bfa

See more details on using hashes here.

File details

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

File metadata

  • Download URL: h3ds-0.2.0-py3-none-any.whl
  • Upload date:
  • Size: 11.5 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.4.2 importlib_metadata/4.8.1 pkginfo/1.7.1 requests/2.26.0 requests-toolbelt/0.9.1 tqdm/4.62.2 CPython/3.6.7

File hashes

Hashes for h3ds-0.2.0-py3-none-any.whl
Algorithm Hash digest
SHA256 88f630b453fe9f31b03be2bd47975dd8560077f733ad167f87800bd153551407
MD5 d07b7c048350aebe455f96a9e11f02e8
BLAKE2b-256 7599d62b2b5ba7d35388e82a6b9217f693e63e1ad5b57e7153bc5b039fb0c5e0

See more details on using hashes here.

Supported by

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