Skip to content

Latest commit

 

History

History
104 lines (96 loc) · 8.16 KB

install_instructions.md

File metadata and controls

104 lines (96 loc) · 8.16 KB
Raw

Installation Instructions for Ubuntu 18.04

  • Install Python 3.6, 3.7 or 3.8

    • We have tested the pipeline with Python 3.8
    • The library versions in SatelliteSurfaceReconstruction/requirements.txt might differ for Python 3.6 and 3.7

  • Install the freeimage plugin for imageio

    • Activate your conda environment (e.g. conda activate <ssr_conda_environment_name>)
    • Start an interactive python session (i.e. by typing python)
    • Download and install the freeimage plugin
      • >>> import imageio
      • >>> imageio.plugins.freeimage.download()

  • Install VisSat

    • Install ColmapForVisSat or ColmapForVisSatPatched

      • Option 1: ColmapForVisSatPatched (RECOMMENDED)
        • Follow the install instructions
          • sudo apt-get install libmetis-dev (Latest tested version: 5.1.0.dfsg-5)
          • To avoid that incorrect libraries are detected by CMake, consider to disable the active anaconda/miniconda environment with conda deactivate
          • Follow the official install instructions of Colmap (for linux)
      • Option 2: ColmapForVisSat
        • Follow the install instructions
          • Make sure you have installed a compatible cuda version (e.g. Cuda 10.0)
            • Cuda 10.0 can be installed following this link.
          • To avoid that incorrect libraries are detected by CMake, consider to disable the active anaconda/miniconda environment with conda deactivate
          • Clone the repository
            • git clone https://github.com/Kai-46/ColmapForVisSat.git
          • Execute ubuntu1804_install_dependencies.sh
          • Execute ubuntu1804_install_colmap.sh

    • Follow the install instructions of VisSatSatelliteStereo

      • Latest tested version of VisSatSatelliteStereo: commit c6cb1b4
      • Install GDAL
        • Option 1: (Recommended)
          • conda install gdal libgdal
            • Activate (or re-activate) your conda environment and make sure gdal environment variables are correctly configured
              • echo $PROJ_LIB
            • RESTART Pycharm to parse the current environment variables!
          • Tested versions: GDAL 3.3.2 with Python 3.8
        • Option 2:
          • Follow the original GDAL install instructions here
          • Tested versions: GDAL 2.4.2 with Python 3.6, released 2019/06/28
      • Clone the repository
        • git clone https://github.com/Kai-46/VisSatSatelliteStereo
        • pip install -r requirements.txt
          • For Python 3.8 use our SatelliteSurfaceReconstruction/requirements.txt instead of VisSatSatelliteStereo/requirements.txt
      • Make sure to ADJUST the --SiftExtraction.num_threads 32 parameter in colmap_sfm_commands.py

  • Install at least one of the following MVS & surface reconstruction libraries

  • Install MVS-Texturing (requires MVE)

  • Install Meshlab

    • Make sure to install Meshlab-2020.09 or older
    • Newer versions do not include the required meshlabserver anymore
    • For a list of releases see here

  • Make VisSatSatelliteStereo and SatelliteSurfaceReconstruction available to your python interpreter

    • Option 1: Add VisSatSatelliteStereo and SatelliteSurfaceReconstruction to the python path

      • Add ssr (in the SatelliteSurfaceReconstruction directory)
        • export PYTHONPATH="${PYTHONPATH}:/path/to/SatelliteSurfaceReconstruction"
      • Add lib etc. (in the VisSatSatelliteStereo directory)
        • export PYTHONPATH="${PYTHONPATH}:/path/to/VisSatSatelliteStereo"
      • This allows to run your pipeline (later) with
        • cd /path/to/SatelliteSurfaceReconstruction/ssr
        • python run_pipeline.py (see the section Run the SSR Pipeline below)

    • Option 2: Use and IDE like Pycharm to manage the project dependencies

      • For example in Pycharm
        • File / Open... / Select SatelliteSurfaceReconstruction
        • File / Open... / Select VisSatSatelliteStereo and attach it to the current SatelliteSurfaceReconstruction project
        • Go to File / Settings / Project: SatelliteSurfaceReconstruction / Project Dependencies
          • Select SatelliteSurfaceReconstruction
          • Make sure that VisSatSatelliteStereo is selected