kopia lustrzana https://github.com/OpenDroneMap/docs
Update Singularity Documentation
The command for running Singularity was incorrect. Additionally, I removed excess Options and Flags which are unnecesary for running this command. This makes it similar in structure to the command for running docker listed here: https://www.opendronemap.org/odm/ Removed the command for running Singularity with ODM, as it was incorrect and was a duplicate of the other command. Fixed link to singularity website.pull/187/head
rodzic
2d6b50b314
commit
f9f5aa2a46
|
@ -299,63 +299,34 @@ Docker has a lamentable use of space and by default does not clean up excess dat
|
||||||
Using Singularity
|
Using Singularity
|
||||||
*****************
|
*****************
|
||||||
|
|
||||||
'Singularity <https://sylabs.io/>'_ is another container platform able to run Docker images. Singularity could be used from laptop to large HPC clusters, local university or company clusters, a single server, in the cloud...
|
[Singularity](https://sylabs.io/) is another container platform able to run Docker images. Singularity can be run both on local machins and in instances where the user does not have root access. Instances where a user may not have root privlidges include HPC clusters and cloud cluster resources.
|
||||||
A container is a single file without anything else to install
|
A container is a single file without anything else to install.
|
||||||
|
|
||||||
Downloading image
|
Downloading image
|
||||||
=================
|
=================
|
||||||
Singularity can use ODM Docker container after their download. It creates .sif images
|
Singularity can use ODM Docker container after their download. It creates .sif images
|
||||||
|
|
||||||
For latest ODM Docker image
|
For latest ODM Docker image (Recommended)
|
||||||
|
|
||||||
.. code:: bash
|
.. code:: bash
|
||||||
|
singularity pull --disable-cache docker://opendronemap/odm:latest
|
||||||
> singularity pull --disable-cache docker://opendronemap/odm:latest
|
|
||||||
|
|
||||||
For latest ODM GPU Docker image
|
For latest ODM GPU Docker image
|
||||||
|
|
||||||
.. code:: bash
|
.. code:: bash
|
||||||
|
singularity pull --disable-cache docker://opendronemap/odm:gpu
|
||||||
> singularity pull --disable-cache docker://opendronemap/odm:gpu
|
|
||||||
|
|
||||||
Using Singularity SIF image
|
Using Singularity SIF image
|
||||||
===========================
|
===========================
|
||||||
|
|
||||||
As Singularity has a different way to map directories than Docker, a bash script file is a good solution to map ODM directories.
|
Once you have used one of the above commands to download and create the `odm_latest.sif` image, it can be ran using singularity.
|
||||||
Here is a linux example for ODM ::
|
Place your images in a directory named “images” (for example /my/project/images) , then simply run
|
||||||
|
|
||||||
images_dir=/path_to_image_dir/
|
..code:: bash
|
||||||
name=`basename $images_dir`
|
|
||||||
output_dir=/path_to_output_directories/$name
|
|
||||||
mkdir -p $output_dir
|
|
||||||
|
|
||||||
singularity run
|
|
||||||
--bind $images_dir:/$output_dir/code/images,\
|
|
||||||
--writable-tmpfs odm_latest.sif \
|
|
||||||
--orthophoto-png --mesh-octree-depth 12 --ignore-gsd --dtm \
|
|
||||||
--smrf-threshold 0.4 --smrf-window 24 --dsm --pc-csv --pc-las --orthophoto-kmz \
|
|
||||||
--ignore-gsd --matcher-type flann --feature-quality ultra --max-concurrency 16 \
|
|
||||||
--use-hybrid-bundle-adjustment --build-overviews --time --min-num-features 10000 \
|
|
||||||
--project-path $output_dir
|
|
||||||
|
|
||||||
|
|
||||||
Here is a linux example for the ODM with GPU ::
|
|
||||||
|
|
||||||
images_dir=/path_to_image_dir/
|
|
||||||
name=`basename $images_dir`
|
|
||||||
output_dir=/path_to_output_directories/$name
|
|
||||||
mkdir -p $output_dir
|
|
||||||
|
|
||||||
singularity run
|
|
||||||
--bind $images_dir:/$output_dir/code/images,\
|
|
||||||
--writable-tmpfs odm_latest.sif \
|
|
||||||
--orthophoto-png --mesh-octree-depth 12 --ignore-gsd --dtm \
|
|
||||||
--smrf-threshold 0.4 --smrf-window 24 --dsm --pc-csv --pc-las --orthophoto-kmz \
|
|
||||||
--ignore-gsd --matcher-type flann --feature-quality ultra --max-concurrency 16 \
|
|
||||||
--use-hybrid-bundle-adjustment --build-overviews --time --min-num-features 10000 \
|
|
||||||
--project-path $output_dir
|
|
||||||
|
|
||||||
|
singularity run --bind /my/project:datasets/code odm_latest.sif --project-path /datasets
|
||||||
|
|
||||||
|
Like with docker, additional Options and Flags can be added to the command.
|
||||||
|
|
||||||
*************************************
|
*************************************
|
||||||
Using ODM from low-bandwidth location
|
Using ODM from low-bandwidth location
|
||||||
|
|
Ładowanie…
Reference in New Issue