Skip to content

Commit 4073e5a

Browse files
dimtzionasvchoutas
authored andcommitted
Update README.md
1 parent c4eef75 commit 4073e5a

File tree

1 file changed

+15
-15
lines changed

1 file changed

+15
-15
lines changed

README.md

+15-15
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
1-
## SMPL-X: A new, unified, 3D model of the human body
1+
## SMPL-X: A new joint 3D model of the human body, face and hands together
22

33
[[Paper Page](https://smpl-x.is.tue.mpg.de/)] [[Paper](https://ps.is.tuebingen.mpg.de/uploads_file/attachment/attachment/497/SMPL-X.pdf)]
44
[[Supp. Mat.](https://ps.is.tuebingen.mpg.de/uploads_file/attachment/attachment/498/SMPL-X-supp.pdf)]
@@ -9,9 +9,9 @@
99
* [License](#license)
1010
* [Description](#description)
1111
* [Installation](#installation)
12-
* [Dowloading the model](#downloading-the-model)
13-
* [Loading SMPL-X, SMPL-H and SMPL](#loading-smpl-x-smpl-h-and-smpl)
14-
* [SMPL and SMPL-H setup](#smpl-and-smpl-h-setup)
12+
* [Downloading the model](#downloading-the-model)
13+
* [Loading SMPL-X, SMPL+H and SMPL](#loading-smpl-x-smpl+h-and-smpl)
14+
* [SMPL and SMPL+H setup](#smpl-and-smpl+h-setup)
1515
* [Model loading](https://github.com/vchoutas/smplx#model-loading)
1616
* [Example](#example)
1717
* [Citation](#citation)
@@ -35,9 +35,9 @@ Our results are obtained on the 483 × 724 pixels resolution of the original ima
3535
*SMPL-X* (SMPL eXpressive) is a unified body model with shape parameters trained jointly for the
3636
face, hands and body. *SMPL-X* uses standard vertex based linear blend skinning with learned corrective blend
3737
shapes, has N = 10, 475 vertices and K = 54 joints,
38-
which includes joints for the neck, jaw, eyeballs and fingers.
39-
SMPL-X is defined by a function M(θ, β, ψ), where θ is the pose parameter, β the shape parameter and
40-
ψ the expression parameter.
38+
which include joints for the neck, jaw, eyeballs and fingers.
39+
SMPL-X is defined by a function M(θ, β, ψ), where θ is the pose parameters, β the shape parameters and
40+
ψ the facial expression parameters.
4141

4242

4343
## Installation
@@ -55,22 +55,22 @@ python setup.py install
5555

5656
## Downloading the model
5757

58-
To download the *SMPL-X* go to the [project website](https://smpl-x.is.tue.mpg.de/) and register to get access to the downloads section.
58+
To download the *SMPL-X* model go to the [project website](https://smpl-x.is.tue.mpg.de/) and register to get access to the downloads section.
5959

60-
## Loading SMPL-X, SMPL-H and SMPL
60+
## Loading SMPL-X, SMPL+H and SMPL
6161

62-
### SMPL and SMPL-H setup
62+
### SMPL and SMPL+H setup
6363

64-
Depending on the model you want to use, please follow the respective download instructions. To switch between SMPL, SMPL-H and SMPL-X just change the *model_path* or *model_type* parameters. For more details check the docs of the model classes.
65-
Before using SMPL and SMPL-H you should follow the instructions in [tools/README.md](./tools/README.md) to remove the
66-
Chumpy objects from both model pkls, as well as merge the MANO parameters with SMPL-H.
64+
The loader gives the option to use any of the SMPL-X, SMPL+H and SMPL models. Depending on the model you want to use, please follow the respective download instructions. To switch between SMPL, SMPL+H and SMPL-X just change the *model_path* or *model_type* parameters. For more details please check the docs of the model classes.
65+
Before using SMPL and SMPL+H you should follow the instructions in [tools/README.md](./tools/README.md) to remove the
66+
Chumpy objects from both model pkls, as well as merge the MANO parameters with SMPL+H.
6767

6868
### Model loading
6969

7070
You can either use the [create](https://github.com/vchoutas/smplx/blob/c63c02b478c5c6f696491ed9167e3af6b08d89b1/smplx/body_models.py#L54)
7171
function from [body_models](./smplx/body_models.py) or directly call the constructor for the
7272
[SMPL](https://github.com/vchoutas/smplx/blob/c63c02b478c5c6f696491ed9167e3af6b08d89b1/smplx/body_models.py#L106),
73-
[SMPL-H](https://github.com/vchoutas/smplx/blob/c63c02b478c5c6f696491ed9167e3af6b08d89b1/smplx/body_models.py#L395) and
73+
[SMPL+H](https://github.com/vchoutas/smplx/blob/c63c02b478c5c6f696491ed9167e3af6b08d89b1/smplx/body_models.py#L395) and
7474
[SMPL-X](https://github.com/vchoutas/smplx/blob/c63c02b478c5c6f696491ed9167e3af6b08d89b1/smplx/body_models.py#L628) model. The path to the model can either be the path to the file with the parameters or a directory with the following structure:
7575
```bash
7676
models
@@ -100,7 +100,7 @@ script to visualize the results. For this step you have to install the [pyrender
100100

101101
## Citation
102102

103-
If you find this code useful in your research then please cite:
103+
If you find this Model & Software useful in your research we would kindly ask you to cite:
104104

105105
```
106106
@inproceedings{SMPL-X:2019,

0 commit comments

Comments
 (0)