Skip to content
/ pRPL Public

parallel Raster Processing Library (pRPL) is a MPI-enabled C++ programming library that provides easy-to-use interfaces to parallelize raster/image processing algorithms

License

Notifications You must be signed in to change notification settings

HPSCIL/pRPL

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

8 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

pRPL

parallel Raster Processing Library (pRPL) is a C++ programming library that provides easy-to-use interfaces to parallelize raster/image processing algorithms.

1. To Compile
Note: this version is not a final release, and some components are still under testsing. The program has been tested on Scientific Linux 6.7 operation system, compiled using g++ 4.9, OpenMPI 1.9, GDAL 1.9, and LibTIFF 4.0. The makefile (i.e., make_pAspect) will compile a demonstration program, pAspect, which is able to calcuate aspect and slope from DEM data in parallel.
(1) Before compiling, make sure MPI, GDAL, and LibTIFF libraries have been installed.
(2) Open make_pAspect and modify the lines that specify the locations of libraries.
(3) Type 'make -f make_pAspect depend'.
(4) Type 'make -f make_pAspect' to compile.
After successful compilation, an executable file named pAspect will be generated.

2. To Run
There is a nd_dem.tif file, which is the DEM data at 1.5km resolution of North Dakota in the US. Note that this data is only for testing if the pAspect program works as expected, not for demonstrating the performance.

2.1 Usage:
mpirun -np <num_proc> pAspect <workspace> <input-demFilename> <num-row-subspaces> <num-col-subspaces> <task-farming(1/0)> <io-option(0/1/2/3/4/5)> <with-writer(1/0)>
workspace: the directory where the input file is located and the output files will be written.
input-demFilename: the input file in the GeoTIFF format, usually the DEM data.
num-row-subspaces: the number of sub-domains in the Y axis, for domain decomposition. If num-row-subspaces > 1 and num-col-subspaces = 1, the domain is decomposed as row-wise; if num-row-subspaces = 1 and num-col-subspaces > 1, the domain is decomposed as column-wise; if both > 1, the domain is decomposed as block-wise.
num-col-subspaces: the number of sub-domains in the X axis, for domain decomposition.
task-farming: load-balancing option, either 0 or 1. if 0, static load-balancing; if 1, task farming.
io-option: I/O option, ranges within [0, 5]. Option 0: GDAL-based centralized reading, no writing; Option 1: GDAL-based parallel reading, no writing; Option 2: pGTIOL-based parallel reading, no writing; Option 3: GDAL-based centralized reading and writing; Option 4: GDAL-based parallel reading and pseudo parallel writing; Option 5: pGTIOL-based parallel reading and parallel writing.
with-writer: an option that specify whether a writer process will be used. If 0, no writer; if 1, use a writer.

2.2 Example:
mpirun -np 8 ./pAspect ./ nd_dem.tif 8 1 0 5 0

3 To Cite in Publications:

  • Miao, J.; Guan, Q.*; Hu, S. 2017. pRPL + pGTIOL: The marriage of a parallel processing library and a parallel I/O library for big raster data. Environmental Modelling and Software, 96: 347-360
  • Guan, Q.; Zeng, W.; Gong, J.; and Yun, S. 2014. pRPL 2.0: improving the parallel raster processing library. Transactions in GIS, 18(S1): 25-52
  • Guan, Q. and Clarke, K. C. 2010. A general-purpose parallel raster processing programming library test application using a geographic cellular automata model. International Journal of Geographical Information Science, 24(5): 695-722

About

parallel Raster Processing Library (pRPL) is a MPI-enabled C++ programming library that provides easy-to-use interfaces to parallelize raster/image processing algorithms

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages