vrn-docker

:whale: Docker files for Large Pose 3D Face Reconstruction from a Single Image via Direct Volumetric CNN Regression

https://github.com/aaronjackson/vrn-docker

Science Score: 41.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
  • DOI references
  • Academic publication links
  • Committers with academic emails
    1 of 2 committers (50.0%) from academic institutions
  • Institutional organization owner
  • JOSS paper metadata
  • Scientific vocabulary similarity
    Low similarity (9.3%) to scientific vocabulary

Keywords

3d-face-reconstruction docker
Last synced: 6 months ago · JSON representation ·

Repository

:whale: Docker files for Large Pose 3D Face Reconstruction from a Single Image via Direct Volumetric CNN Regression

Basic Info
  • Host: GitHub
  • Owner: AaronJackson
  • Language: Lua
  • Default Branch: master
  • Homepage:
  • Size: 579 KB
Statistics
  • Stars: 383
  • Watchers: 17
  • Forks: 177
  • Open Issues: 7
  • Releases: 0
Topics
3d-face-reconstruction docker
Created almost 5 years ago · Last pushed about 2 years ago
Metadata Files
Readme Citation

README.org

* Docker build for vrn code

If you've been redirected here from the 3D face reconstruction demo website: Sorry, I turned it off.

This is intended to work on CPU. Will modify eventually to have CUDA
support. It's available on DockerHub but you are welcome to build it
yourself too. If you feel like doing this yourself, please feel free to
send a pull request to a branch called cuda.

** Setup

*** Dockerhub

The pre-built docker image is available on Docker Hub and includes the CPU float versions of the models. 

#+BEGIN_SRC
sudo docker pull asjackson/vrn:latest
#+END_SRC

*** Build docker manually

The model files were originally held in GitHub's LFS, but I ran out of space. If you want to build the container
yourself, feel free to ask me for links to these files, or alternatively grab them from inside the Docker Hub
container.

#+BEGIN_SRC
git clone
cd vrn-docker
docker build -t vrn .
#+END_SRC

** Running the container

An example image of Alan Turing is available in the folder ~data~,
this needs to be bind mounted to ~/data~ in the container. With any
luck, ~data/turing.jpg.obj~ will be created.

#+BEGIN_SRC
docker run -v $PWD/data:/data:Z asjackson/vrn /runner/run.sh /data/turing.jpg
#+END_SRC

The Z suffix changes the SELinux context of the directory so that it can be accessed on systems
which have SELinux enabled. This might not be necessary on some distributions, such as Ubuntu,
where SELinux is disabled by default. However, it is likely required under CentOS and Fedora.

Owner

  • Name: Aaron S. Jackson
  • Login: AaronJackson
  • Kind: user
  • Location: Nottingham, UK
  • Company: University of Dundee

"What are you doing here?" ~ 🐴 Bojack Horseman, 2015

Citation (CITATION.bib)

@article{jackson2017vrn,
  title={Large Pose 3D Face Reconstruction from a Single Image via Direct Volumetric CNN Regression},
  author={Jackson, Aaron S and Bulat, Adrian and Argyriou, Vasileios and Tzimiropoulos, Georgios},
  journal={International Conference on Computer Vision},
  year={2017}
}

GitHub Events

Total
  • Watch event: 5
Last Year
  • Watch event: 5

Committers

Last synced: 9 months ago

All Time
  • Total Commits: 7
  • Total Committers: 2
  • Avg Commits per committer: 3.5
  • Development Distribution Score (DDS): 0.286
Past Year
  • Commits: 0
  • Committers: 0
  • Avg Commits per committer: 0.0
  • Development Distribution Score (DDS): 0.0
Top Committers
Name Email Commits
Aaron Jackson a****n@a****k 5
Aaron Jackson a****n@n****k 2
Committer Domains (Top 20 + Academic)

Issues and Pull Requests

Last synced: 9 months ago

All Time
  • Total issues: 21
  • Total pull requests: 10
  • Average time to close issues: about 2 months
  • Average time to close pull requests: 2 days
  • Total issue authors: 17
  • Total pull request authors: 9
  • Average comments per issue: 2.14
  • Average comments per pull request: 0.7
  • Merged pull requests: 0
  • Bot issues: 0
  • Bot pull requests: 0
Past Year
  • Issues: 0
  • Pull requests: 0
  • Average time to close issues: N/A
  • Average time to close pull requests: N/A
  • Issue authors: 0
  • Pull request authors: 0
  • Average comments per issue: 0
  • Average comments per pull request: 0
  • Merged pull requests: 0
  • Bot issues: 0
  • Bot pull requests: 0
Top Authors
Issue Authors
  • ghost (3)
  • ArtemideArte (2)
  • XEODIX (2)
  • alex-wdmg (1)
  • Noel212 (1)
  • hekimgil (1)
  • BarkleyHoldings (1)
  • jmone1 (1)
  • ElMutanto (1)
  • 3dfa (1)
  • paradocx (1)
  • mben0 (1)
  • Zarjor12 (1)
  • alex-khramov (1)
  • JL-Works (1)
Pull Request Authors
  • ahmadjavan (1)
  • Marcos1488 (1)
  • israelsipes (1)
  • didibeach (1)
  • slavachernous (1)
  • Ed3D252766 (1)
  • 01813321212 (1)
  • Ja8824317 (1)
  • bridge5555 (1)
Top Labels
Issue Labels
Pull Request Labels

Dependencies

Dockerfile docker
  • centos 7 build