sporada/file-setup
1
0
Fork 0
mirror of https://gitlab.ub.uni-bielefeld.de/sfb1288inf/file-setup.git synced 2024-09-21 01:52:51 +00:00
Code Issues Projects Releases Wiki Activity
cdb4f1889c
file-setup/README.md
Patrick Jentsch cdb4f1889c Update Pipeline structure
2022-01-18 12:58:42 +01:00

1.5 KiB
Raw Blame History

File setup

This software implements a parallelized pipeline to setup image files. It is used for nopaque's File setup service but you can also use it standalone, for that purpose a convenient wrapper script is provided. The pipeline is designed to run on Linux operating systems, but with some tweaks it should also run on Windows with WSL installed.

Software used in this pipeline implementation

Installation

  1. Install Docker and Python 3.
  2. Clone this repository: git clone https://gitlab.ub.uni-bielefeld.de/sfb1288inf/file-setup.git
  3. Build the Docker image: docker build -t gitlab.ub.uni-bielefeld.de:4567/sfb1288inf/file-setup:v0.1.0 file-setup
  4. Add the wrapper script (wrapper/filesetup relative to this README file) to your ${PATH}.
  5. Create working directories for the pipeline: mkdir -p /<my_data_location>/{input,output}.

Use the Pipeline

  1. Place your images files inside a subdirectory in /<my_data_location>/input. It should look similar to this:
.
|-- input
|   |-- alice_in_wonderland
|       |-- page-1.png
|       |-- page-2.png
|       |-- ...
|       `-- page-x.png
`-- output
  1. Start the pipeline process. Check the pipeline help (file-setup --help) for more details.
cd /<my_data_location>
file-setup -i input -o output
  1. Check your results in the /<my_data_location>/output directory.