README update

Author: Zielon

.gitignore

@@ -57,7 +57,7 @@ __dump
 
 ## visual code files
 .vscode
-
+render_dataset.py
 shapes.pt
 partial
 images

README.md

@@ -32,9 +32,13 @@ cd MICA
 ```
 you will be asked to provide `{flame_user}` and `{flame_password}` for your FLAME account in order to access the file server.
 
-### Pre-trained Model
+### Pre-trained Models
 
-If you decide to not use the installation script, the pretrained model can be found under the [MPI-IS storage server](https://keeper.mpdl.mpg.de/f/db172dc4bd4f4c0f96de/?dl=1). After downloading, please place it in the `/data/pretrained/mica.tar` location.
+If you decide to not use the installation script, the pretrained model can be found under the [MPI-IS storage server](https://keeper.mpdl.mpg.de/f/db172dc4bd4f4c0f96de/?dl=1). After downloading, please place it in the `/data/pretrained/mica.tar` location. Additionally, you will need to provide models for `inisghtface`:
+1) [antelopev2](https://keeper.mpdl.mpg.de/f/2d58b7fed5a74cb5be83/?dl=1)
+2) [buffalo_l](https://keeper.mpdl.mpg.de/f/8faabd353cfc457fa5c5/?dl=1)
+
+then you need to unzip them and place in `~/.insightface/models/`. The `install.sh` script does it for you.
 
 ### How To Use
 
@@ -53,7 +57,7 @@ The testing was done using two datasets, [Stirling](http://pics.stir.ac.uk/ESRC/
 ### Citation
 If you use this project in your research please cite MICA:
 ```bibtex
-@article{MICA:ECCV2022,
+@proceedings{MICA:ECCV2022,
   author = {Zielonka, Wojciech and Bolkart, Timo and Thies, Justus},
   title = {Towards Metrical Reconstruction of Human Faces},
   journal = {European Conference on Computer Vision},

datasets/README.md

@@ -8,18 +8,70 @@ To obtain the dataset please follow each link separately and request the given s
 In the case of any questions feel free to <a href="mailto:&#109;&#105;&#099;&#097;&#064;&#116;&#117;&#101;&#046;&#109;&#112;&#103;&#046;&#100;&#101;">email us</a>.
 
 <div align="center">
-
-| Dataset                    | Subjects | Source                                                                                                                       |
-|----------------------------|----------|------------------------------------------------------------------------------------------------------------------------------|
-| **Stirling**               | 133      | <a href="http://pics.stir.ac.uk/ESRC/" target="_blank">pics.stir.ac.uk</a>                                                   |
-| **D3DFACS**                | 10       | <a href="https://www.cs.bath.ac.uk/~dpc/D3DFACS/" target="_blank">cs.bath.ac.uk</a>                                          |
-| **Florence 2D/3D**         | 53       | <a href="https://www.micc.unifi.it/resources/datasets/florence-3d-faces/" target="_blank">micc.unifi.it</a>                  |
-| **BU-3DFE**                | 100      | <a href="https://www.cs.binghamton.edu/~lijun/Research/3DFE/3DFE_Analysis.html" target="_blank">cs.binghamton.edu</a>        |
-| **LYHM**                   | 1211     | <a href="https://www-users.cs.york.ac.uk/~nep/research/LYHM/" target="_blank">cs.york.ac.uk</a>                              |
-| **FaceWarehouse**          | 150      | <a href="http://kunzhou.net/zjugaps/facewarehouse/" target="_blank">kunzhou.net</a>                                          |
-| **[FRGC](#frgc-subset)**   | 531      | <a href="https://cvrl.nd.edu/projects/data/#face-recognition-grand-challenge-frgc-v20-data-collection" target="_blank">cvrl.nd.edu</a> |
-| **[BP4D+](#bp4d-subset)** | 127      | <a href="http://www.cs.binghamton.edu/~lijun/Research/3DFE/3DFE_Analysis.html" target="_blank">cs.binghamton.edu</a>           |
-
+<table cellspacing="0" cellpadding="0" bgcolor="#ffffff" border="0">
+  <tr>
+    <th>FLAME Renderings</th>
+    <th>Dataset</th>
+    <th>Subjects</th>
+    <th>Source</th>
+  </tr>
+  <tr></tr>
+  <tr>
+    <td><img src="../documents/STIRLING.gif"></td>
+    <td><b>Stirling</b></td>
+    <td>133</td>
+    <td><a href="http://pics.stir.ac.uk/ESRC/" target="_blank">pics.stir.ac.uk</a></td>
+  </tr>
+  <tr></tr>
+  <tr>
+    <td><img src="../documents/D3DFACS.gif"></td>
+    <td><b>D3DFACS</b></td>
+    <td>10</td>
+    <td><a href="https://www.cs.bath.ac.uk/~dpc/D3DFACS/" target="_blank">cs.bath.ac.uk</a></td>
+  </tr>
+  <tr></tr>
+  <tr>
+    <td><img src="../documents/FLORENCE.gif"></td>
+    <td><b>Florence 2D/3D</b></td>
+    <td>53</td>
+    <td><a href="https://www.micc.unifi.it/resources/datasets/florence-3d-faces/" target="_blank">micc.unifi.it</a></td>
+  </tr>
+  <tr></tr>
+  <tr>
+    <td><img src="../documents/BU3DFE.gif"></td>
+    <td><b>BU-3DFE</b></td>
+    <td>100</td>
+    <td><a href="https://www.cs.binghamton.edu/~lijun/Research/3DFE/3DFE_Analysis.html" target="_blank">cs.binghamton.edu</a></td>
+  </tr>
+  <tr></tr>
+  <tr>
+    <td><img src="../documents/LYHM.gif"></td>
+    <td><b>LYHM</b></td>
+    <td>1211</td>
+    <td><a href="https://www-users.cs.york.ac.uk/~nep/research/LYHM/" target="_blank">cs.york.ac.uk</a></td>
+  </tr>
+  <tr></tr>
+  <tr>
+    <td><img src="../documents/FACEWAREHOUSE.gif"></td>
+    <td><b>FaceWarehouse</b></td>
+    <td>150</td>
+    <td><a href="http://kunzhou.net/zjugaps/facewarehouse/" target="_blank">kunzhou.net</a></td>
+  </tr>
+  <tr></tr>
+  <tr>
+    <td><img src="../documents/FRGC.gif"></td>
+    <td><b>FRGC</b></td>
+    <td>531</td>
+    <td><a href="https://cvrl.nd.edu/projects/data/#face-recognition-grand-challenge-frgc-v20-data-collection" target="_blank">cvrl.nd.edu</a</td>
+  </tr>
+  <tr></tr>
+  <tr>
+    <td><img src="../documents/BP4D.gif"></td>
+    <td><b>BP4D+</b></td>
+    <td>127</td>
+    <td><a href="http://www.cs.binghamton.edu/~lijun/Research/3DFE/3DFE_Analysis.html" target="_blank">cs.binghamton.edu</a></td>
+  </tr>
+</table>
 </div>
 
 Each subset zip file has the following structure: