mirror of
https://github.com/alicevision/Meshroom.git
synced 2025-08-06 10:18:42 +02:00
[setup] split dev requirements + update install doc
This commit is contained in:
parent
cb285a63f5
commit
1a1251a9af
5 changed files with 17 additions and 47 deletions
40
INSTALL.md
40
INSTALL.md
|
@ -19,43 +19,14 @@ ALICEVISION_SENSOR_DB=/path/to/database
|
||||||
ALICEVISION_VOCTREE=/path/to/voctree
|
ALICEVISION_VOCTREE=/path/to/voctree
|
||||||
```
|
```
|
||||||
|
|
||||||
### Python 2.7
|
### Python Environment
|
||||||
|
* Python 2 (>= 2.7) or Python 3 (>=3.5)
|
||||||
### Pyside2 (for Qt >= 5.10)
|
|
||||||
#### Update (02/05/2018)
|
|
||||||
[Python for Qt](http://blog.qt.io/blog/2018/04/13/qt-for-python-is-coming-to-a-computer-near-you/) is becoming official
|
|
||||||
and [beta python wheels](http://download.qt.io/snapshots/ci/pyside/5.11/latest/pyside2/) are now provided.
|
|
||||||
|
|
||||||
|
To install all the requirements for runtime, development and packaging, simply run:
|
||||||
```bash
|
```bash
|
||||||
pip install --index-url=http://download.qt.io/snapshots/ci/pyside/5.11/latest/ pyside2 --trusted-host download.qt.io
|
pip install -r requirements.txt -r dev_requirements.txt
|
||||||
```
|
|
||||||
|
|
||||||
#### Build Instructions (based on [this guide](https://fredrikaverpil.github.io/2016/08/17/compiling-pyside2/))
|
|
||||||
|
|
||||||
Since PySide2 is (not yet) available in Qt installer and no prebuilt binaries are available for Qt 5.10,
|
|
||||||
you'll need to build it from source. The build procedure is quite similar on all platforms.
|
|
||||||
|
|
||||||
Pre-requisites:
|
|
||||||
* [Python 2.7](https://www.python.org/)
|
|
||||||
* [Qt 5.10](http://download.qt.io/official_releases/online_installers/)
|
|
||||||
* [llvm/libclang](http://download.qt.io/development_releases/prebuilt/libclang/)
|
|
||||||
* [CMake](https://cmake.org/download/)
|
|
||||||
|
|
||||||
##### Procedure
|
|
||||||
This procedure directly installs PySide as a package of the Python used for calling the setup script.
|
|
||||||
Make sure to use virtualenv if you want to keep this in a separate Python environment.
|
|
||||||
|
|
||||||
To simplify the build process, you can add 'bin' folders of cmake, llvm and qt in your PATH.
|
|
||||||
Alternatively, paths to binaries can be explicitely set when calling the setup.py script (as shown below).
|
|
||||||
|
|
||||||
```
|
|
||||||
# With {libclang}/bin in PATH
|
|
||||||
# /!\ branch 5.10 does not exist yet, but branch 5.9 is compatible with Qt-5.10
|
|
||||||
git clone --recursive --branch 5.9 https://codereview.qt-project.org/pyside/pyside-setup
|
|
||||||
|
|
||||||
cd pyside-setup
|
|
||||||
python setup.py --ignore-git install --cmake=/path/to/cmake --qmake=/path/to/qmake
|
|
||||||
```
|
```
|
||||||
|
> Node: `dev_requirements` is only related to testing and packaging. It is not mandatory to run Meshroom.
|
||||||
|
|
||||||
### Qt Plugins
|
### Qt Plugins
|
||||||
Additional Qt plugins can be built to extend Meshroom UI features. They can be found on separate repositories,
|
Additional Qt plugins can be built to extend Meshroom UI features. They can be found on separate repositories,
|
||||||
|
@ -68,4 +39,3 @@ Adds support for Alembic file loading in Meshroom's 3D viewport. Allows to visua
|
||||||
|
|
||||||
#### [QtOIIO](https://github.com/alicevision/QtOIIO)
|
#### [QtOIIO](https://github.com/alicevision/QtOIIO)
|
||||||
Use OpenImageIO as backend to load images in Qt. Allow to visualize RAW/EXR images in Meshroom.
|
Use OpenImageIO as backend to load images in Qt. Allow to visualize RAW/EXR images in Meshroom.
|
||||||
|
|
||||||
|
|
|
@ -1,4 +1,4 @@
|
||||||
# 
|
# 
|
||||||
|
|
||||||
Meshroom is a free, open-source 3D Reconstruction Software based on the [AliceVision](https://github.com/alicevision/AliceVision) framework.
|
Meshroom is a free, open-source 3D Reconstruction Software based on the [AliceVision](https://github.com/alicevision/AliceVision) framework.
|
||||||
|
|
||||||
|
@ -6,7 +6,8 @@ Learn more details about the pipeline on [AliceVision website](http://alicevisio
|
||||||
|
|
||||||
See [results of the pipeline on sketchfab](http://sketchfab.com/AliceVision).
|
See [results of the pipeline on sketchfab](http://sketchfab.com/AliceVision).
|
||||||
|
|
||||||
|
Continous integration:
|
||||||
|
* Windows: [](https://ci.appveyor.com/project/AliceVision/meshroom/branch/develop)
|
||||||
## Photogrammetry
|
## Photogrammetry
|
||||||
|
|
||||||
Photogrammetry is the science of making measurements from photographs.
|
Photogrammetry is the science of making measurements from photographs.
|
||||||
|
@ -26,13 +27,13 @@ The project is released under MPLv2, see [**COPYING.md**](COPYING.md).
|
||||||
|
|
||||||
See [**INSTALL.md**](INSTALL.md) to setup the project and pre-requisites.
|
See [**INSTALL.md**](INSTALL.md) to setup the project and pre-requisites.
|
||||||
|
|
||||||
Get the source code:
|
Get the source code and install runtime requirements:
|
||||||
```bash
|
```bash
|
||||||
git clone --recursive git://github.com/alicevision/meshroom
|
git clone --recursive git://github.com/alicevision/meshroom
|
||||||
cd meshroom
|
cd meshroom
|
||||||
|
pip install -r requirements.txt
|
||||||
```
|
```
|
||||||
|
|
||||||
|
|
||||||
## Start Meshroom
|
## Start Meshroom
|
||||||
|
|
||||||
You need to have [AliceVision](https://github.com/alicevision/AliceVision) installation in your PATH and LD_LIBRARY_PATH.
|
You need to have [AliceVision](https://github.com/alicevision/AliceVision) installation in your PATH and LD_LIBRARY_PATH.
|
||||||
|
|
|
@ -6,9 +6,9 @@ environment:
|
||||||
|
|
||||||
install:
|
install:
|
||||||
- "set PATH=%PYTHON%;%PYTHON%\\Scripts;%PATH%"
|
- "set PATH=%PYTHON%;%PYTHON%\\Scripts;%PATH%"
|
||||||
- "pip install -r requirements.txt"
|
- "pip install -r requirements.txt -r dev_requirements.txt"
|
||||||
|
|
||||||
build: off
|
build: off
|
||||||
|
|
||||||
test_script:
|
test_script:
|
||||||
- "pytest tests/"
|
- "pytest tests/"
|
||||||
|
|
5
dev_requirements.txt
Normal file
5
dev_requirements.txt
Normal file
|
@ -0,0 +1,5 @@
|
||||||
|
# packaging
|
||||||
|
cx_Freeze
|
||||||
|
|
||||||
|
# testing
|
||||||
|
pytest
|
|
@ -1,9 +1,3 @@
|
||||||
# packaging
|
|
||||||
cx_Freeze
|
|
||||||
|
|
||||||
# testing
|
|
||||||
pytest
|
|
||||||
|
|
||||||
# runtime
|
# runtime
|
||||||
psutil
|
psutil
|
||||||
enum34;python_version<"3.4"
|
enum34;python_version<"3.4"
|
||||||
|
|
Loading…
Add table
Add a link
Reference in a new issue