This code enables the loading, processing, and evaluation of the OSSO dataset released as a UKBiobank dataset return (release planned for November 2023). We release, for 2400 subjects, pairs of skeleton and body meshes as well as the corresponding STAR body model parameters. The meshes are generated from the subjects' DXA scans, see the project page for details.
This code lets you:
- Visualize the mesh data (Requires our UKBiobank dataset return)
- Compare our mesh silhouettes with the corresponding DXA silhouettes. (Requires access to UK Biobank link)
- We also release the code to extract the body and skeleton silhouette from a DXA scan.
python3.8 -m venv ukb_env
source ukb_env/bin/activate
pip install git+https://github.com/MPI-IS/mesh.git
pip install -r requirements.txt
pip install -e .
Finally, in config.py, set the paths to the UK Biobank dataset and the returned dataset.
If you want to use the STAR parameters, you will need the body model STAR.
Load a subject's DXA from the UK Biobank dataset:
python demos/load_dxa.py
Load the subject's 3D meshes and STAR parameters from our dataset return:
python demos/load_return.py
Preprocess a DXA to extract the body and skeleton silhouette: python demos/dxa_process.py
Visualize and evaluate the overlap between the meshes and the DXA scan: python demos/fit_eval.py
If you find this dataset & software useful in your research, please consider citing:
@inproceedings{Keller:CVPR:2022,
title = {{OSSO}: Obtaining Skeletal Shape from Outside},
author = {Keller, Marilyn and Zuffi, Silvia and Black, Michael J. and Pujades, Sergi},
booktitle = {Proceedings IEEE/CVF Conf.~on Computer Vision and Pattern Recognition (CVPR)},
month = jun,
year = {2022},
pages = {20460--20469},
month_numeric = {6}}
This code and model are available for non-commercial scientific research purposes as defined in the LICENSE.txt file.
For more questions, please contact osso@tue.mpg.de
For commercial licensing, please contact ps-licensing@tue.mpg.de