Skip to content

Commit 276ea65

Browse files
committed
Update readme
1 parent ace47cb commit 276ea65

File tree

1 file changed

+19
-34
lines changed

1 file changed

+19
-34
lines changed

readme.md

+19-34
Original file line numberDiff line numberDiff line change
@@ -5,47 +5,32 @@ Photogrammetry pipeline using [OpenMVG](https://github.com/openMVG/openMVG) and
55
(Also includes [CMVS](https://github.com/pmoulon/CMVS-PMVS) and [COLMAP](https://github.com/colmap/colmap)).
66

77
## Installation
8-
Windows:
9-
1. Install Windows Subsystem for Linux (Ubuntu 16.04)
10-
2. Clone repository
11-
3. ```sudo ./build.sh```
128

13-
Linux (Ubuntu 16.04):
14-
1. Clone repository
15-
2. ```sudo ./build.sh```
9+
### Docker
10+
You can either use `spedenaave/dpg` image from the docker hub or build it by yourself by first cloning the repository and then using `docker build -t dpg .` command.
1611

17-
Docker:
12+
Be adviced that the default setting of docker for windows and mac only give the container access to a very limited amount of system resources. You can increase the amount of cpu cores and memory from the advanced settings.
1813

19-
You can either use a prebuilt image or build it by youself. To use the prebuilt image:
14+
### Linux (or Windows Subsystem for Linux)
15+
This method will build and install required binaries directly to your linux installation. **It is not recommended!**
16+
```
17+
git clone https://github.com/rennu/dpg /tmp/dpg && cd /tmp/dpg
18+
sudo ./build.sh
19+
```
2020

21-
```docker run -v $(pwd):/datasets --rm -it spedenaave/dpg```
22-
23-
To build and run the image by yourself:
24-
25-
1. Clone repository
26-
2. ```docker build -t dpg .```
27-
3. ```docker run -v $(pwd):/datasets --rm -it dpg```
28-
29-
## Examples
21+
## Example usage
3022

3123
### Mesh Reconstruction with Textures by using Incremental Structure from Motion
32-
1. Download [example image set](https://github.com/openMVG/ImageDataset_SceauxCastle), open it up in terminal and run the docker image (see above)
33-
2. Run pipeline:
34-
35-
36-
```pipeline.py --input /datasets/images --output /datasets/output --sfm-type incremental --geomodel f --run-openmvg --run-openmvs```
3724

38-
3. Open your model for example using meshlab. The model is named "scene_mesh_refine_texture.ply" and it's under $datasets/ImageDataset_SceauxCastle/sfm/mvs directory
25+
In this short example we first clone an example dataset to /tmp/example, then start docker with -v argument to mount /tmp/example to /datasets inside the container, and finally we the run pipeline.
26+
```
27+
git clone https://github.com/openMVG/ImageDataset_SceauxCastle /tmp/example
28+
docker run -v /tmp/example:/datasets --rm -it spedenaave/dpg
29+
pipeline.py --input /datasets/images --output /datasets/output --sfm-type incremental --geomodel f --run-openmvg --run-openmvs
30+
```
3931

40-
You should end up with something like this (press ctrl/cmd-k to disable backface culling) ![Example 1](https://i.imgur.com/CpSs2SE.jpg)
41-
42-
### Dense Mesh Reconstruction with Textures by using Incremental Structure from Motion
43-
1. Download [example image set](https://github.com/openMVG/ImageDataset_SceauxCastle), open it up in terminal and run the docker image (see above)
44-
2. Run pipeline:
45-
46-
```pipeline.py --input /datasets/images --output /datasets/output_dense --sfm-type incremental --geomodel f --run-openmvg --run-openmvs --densify```
47-
48-
The end result should look something like this ![Example 2](https://i.imgur.com/lVerEpa.jpg)
32+
You should now have a reconstructed model at /tmp/example/omvs folder. Use meshlab or something similar to open it. The end result should look something like this:
33+
![Example 1](https://i.imgur.com/CpSs2SE.jpg)
4934

5035
## Pipeline Options
5136

@@ -221,4 +206,4 @@ The end result should look something like this ![Example 2](https://i.imgur.com/
221206
--txemptycolor [int]
222207
Color of surfaces OpenMVS TextureMesh is unable to texture.
223208
Default: 0 (black)
224-
209+

0 commit comments

Comments
 (0)