pl-parallelex

Table of Contents

• Abstract
• Synopsis
• Description
• Agruments
• Run
  • Using PyPI
  • Using docker run
• Examples

Abstract

This application provides a module/framework for parallel plugin execution.

Synopsis

python parallelex.py                                           \
    [-v <level>] [--verbosity <level>]                          \
    [--version]                                                 \
    [--man]                                                     \
    [--meta]                                                    \
    <inputDir>
    <outputDir>

Description

parallelex.py is a ChRIS-based application that...

Agruments

[-v <level>] [--verbosity <level>]
Verbosity level for app. Not used currently.

[--version]
If specified, print version number.

[--man]
If specified, print (this) man page.

[--meta]
If specified, print plugin meta data.

Run

This plugin can be run in two modes: natively as a python package or as a containerized docker image.

Using PyPI

To run from PyPI, simply do a

pip install parallelex

and run with

parallelex.py --man /tmp /tmp

to get inline help. The app should also understand being called with only two positional arguments

parallelex.py /some/input/directory /destination/directory

Using docker run

To run using docker, be sure to assign an "input" directory to /incoming and an output directory to /outgoing. Make sure that the $(pwd)/out directory is world writable!

Now, prefix all calls with

docker run --rm -v $(pwd)/out:/outgoing                             \
        fnndsc/pl-parallelex parallelex.py                        \

Thus, getting inline help is:

mkdir in out && chmod 777 out
docker run --rm -v $(pwd)/in:/incoming -v $(pwd)/out:/outgoing      \
        fnndsc/pl-parallelex parallelex.py                        \
        --man                                                       \
        /incoming /outgoing

Examples