mirror of
https://github.com/alicevision/Meshroom.git
synced 2025-08-03 00:38:41 +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
|
||||
```
|
||||
|
||||
### Python 2.7
|
||||
|
||||
### 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.
|
||||
### Python Environment
|
||||
* Python 2 (>= 2.7) or Python 3 (>=3.5)
|
||||
|
||||
To install all the requirements for runtime, development and packaging, simply run:
|
||||
```bash
|
||||
pip install --index-url=http://download.qt.io/snapshots/ci/pyside/5.11/latest/ pyside2 --trusted-host download.qt.io
|
||||
```
|
||||
|
||||
#### 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
|
||||
pip install -r requirements.txt -r dev_requirements.txt
|
||||
```
|
||||
> Node: `dev_requirements` is only related to testing and packaging. It is not mandatory to run Meshroom.
|
||||
|
||||
### Qt Plugins
|
||||
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)
|
||||
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.
|
||||
|
||||
|
@ -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).
|
||||
|
||||
|
||||
Continous integration:
|
||||
* Windows: [](https://ci.appveyor.com/project/AliceVision/meshroom/branch/develop)
|
||||
## Photogrammetry
|
||||
|
||||
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.
|
||||
|
||||
Get the source code:
|
||||
Get the source code and install runtime requirements:
|
||||
```bash
|
||||
git clone --recursive git://github.com/alicevision/meshroom
|
||||
cd meshroom
|
||||
pip install -r requirements.txt
|
||||
```
|
||||
|
||||
|
||||
## Start Meshroom
|
||||
|
||||
You need to have [AliceVision](https://github.com/alicevision/AliceVision) installation in your PATH and LD_LIBRARY_PATH.
|
||||
|
|
|
@ -6,9 +6,9 @@ environment:
|
|||
|
||||
install:
|
||||
- "set PATH=%PYTHON%;%PYTHON%\\Scripts;%PATH%"
|
||||
- "pip install -r requirements.txt"
|
||||
- "pip install -r requirements.txt -r dev_requirements.txt"
|
||||
|
||||
build: off
|
||||
|
||||
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
|
||||
psutil
|
||||
enum34;python_version<"3.4"
|
||||
|
|
Loading…
Add table
Add a link
Reference in a new issue