Skip to main content

Python interface for H3DS dataset

Project description

H3DS Dataset

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

Access

The H3DS dataset is available only for academic purposes. To request access, start by filling the contact form with your academic email and a license agreement will be sent back, which must be completed by a full-time academic staff member. Finally, you'll be provided with a H3DS_ACCESS_TOKEN to use the dataset.

Setup

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

pip install h3ds

Using H3DS

In order to use the dataset, simply import the package in your python scripts.

from h3ds.dataset import H3DS

h3ds = H3DS(path='local/path/to/h3ds')

If it's the first time using H3DS, download the data (less than 500 Mb).

h3ds.download(token=H3DS_ACCESS_TOKEN)

You can easily list the ids of the available scenes

scenes = h3ds.scenes()

and load the data from a concrete scene as:

mesh, images, masks, cameras = h3ds.load_scene(scene_id='1b2a8613401e42a8')

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.0.5.tar.gz (7.0 kB view details)

Uploaded Source

Built Distribution

h3ds-0.0.5-py3-none-any.whl (7.6 kB view details)

Uploaded Python 3

File details

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

File metadata

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

File hashes

Hashes for h3ds-0.0.5.tar.gz
Algorithm Hash digest
SHA256 ea2efc55793d90062081fad2a6a232ccfb30e504f9119e59a389d66f72bb9310
MD5 74ca7287ba4c0175e34a031d5ff94897
BLAKE2b-256 3ff54fb60ca8dff2ae29b42e21d20ca53878928d5fd25cf223ed6bf8c0ff87a3

See more details on using hashes here.

File details

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

File metadata

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

File hashes

Hashes for h3ds-0.0.5-py3-none-any.whl
Algorithm Hash digest
SHA256 4156f1012b80201825cf4daf12e62d1f7f2a33bd65464adf969a1c201a7c8c0f
MD5 f7be2b98b725b958790cc2f0ffc64899
BLAKE2b-256 a2d458e4c92872814a99c14b318053561fbe44b34162a25cf91b799ab0aae80e

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