Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Jump to bottom

Update README.org #162

Open
wants to merge 1 commit into
base: master
Choose a base branch
from
Open

Update README.org #162

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
10 changes: 5 additions & 5 deletions README.org
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -8,7 +8,7 @@ pull the DockerHub image `asjackson:vrn`, see docs in the [[https://github.com/A
[[http://aaronsplace.co.uk/papers/jackson2017recon/preview.png]]

Please visit our [[http://aaronsplace.co.uk/papers/jackson2017recon/][project webpage]] for a link to the paper and an
example video run on 300VW. This code is licenses under the MIT
example video run on 300VW. This code is licensed under the MIT
License, as described in the LICENSE file.

This is an unguided version of the Volumetric Regression Network (VRN)
Expand All @@ -20,7 +20,7 @@ obtained by taking the isosurface of this volume.
Several example images are included in the examples folder. Most of
these are AFLW images taken from [[http://www.cbsr.ia.ac.cn/users/xiangyuzhu/projects/3DDFA/main.htm][3DDFA]].

If you are running the code to calculate error for a potential
If you are running the code to calculate an error for a potential
publication, please use the MATLAB version, as this is what was used
to compute the error for the paper.

Expand Down Expand Up @@ -59,7 +59,7 @@ Quick overview of requirements:
- MATLAB
- bash, ImageMagick, GNU awk, Python 2.7 (+ visvis, imageio, numpy)

Please be wary of the version numbers for CUDA, CuDNN and Python.
Please be wary of the version numbers for CUDA, CuDNN, and Python.

Bulat's [[https://github.com/1adrianb/2D-and-3D-face-alignment/][face alignment]] code is included as a submodule. Please check
his README for dependencies.
Expand All @@ -84,10 +84,10 @@ To run, type "run" from MATLAB.

No longer is MATLAB an absolute requirement! I've included a slightly
crazy (but don't worry, I had fun writing it) shell script which
performs the face normalisation, and runs the ~vis.py~ script to
performs the face normalization, and runs the ~vis.py~ script to
render the regressed volume.

Unfortunately this does not yet apply any colouring or texture to the
Unfortunately, this does not yet apply any colouring or texture to the
mesh (you're welcome to contribute) and it has some issues if you
don't have a fully working OpenGL setup. Some GPUs won't like the
background image not being a power of two, so it might make the
Expand Down