SERVICE DETAILS
ImageMagick Service
Overview
OSCAR service for lightweight image processing with ImageMagick. For every input image, it generates a grayscale PNG, an edge-enhanced PNG, and a JSON file with width, height, brightness, contrast, and edge-density metrics. It supports both asynchronous storage-driven execution and synchronous invocations, and it bundles a didactic Jupyter notebook plus sample images for teaching and self-guided experimentation.
Deployment requirements
- Memory
- 512 MiB
- Processors
- 0.5 vCPU0 GPU
Software
- ImageMagick (opens in a new tab)7.1.2-26
- MinIO (opens in a new tab)RELEASE.2025-10-15T17-29-55Z
Files & artifacts
- fdl.yml (opens in a new tab)text/yaml
OSCAR Service Definition
Show content of fdl.yml
- script.sh (opens in a new tab)text/x-shellscript
OSCAR Service Script
Show content of script.sh
- README.md (opens in a new tab)text/markdown
Usage Notes
Show content of README.md
- oscar-image-processing-notebook.ipynb (opens in a new tab)application/x-ipynb+json
Teaching notebook — Jupyter notebook that explains the OSCAR, MinIO, and Jupyter workflow and guides users through the analysis of the generated visual metrics.
Show content of oscar-image-processing-notebook.ipynb
- docker/Dockerfile (opens in a new tab)text/x-dockerfile
Multi-arch container build recipe
Show content of docker/Dockerfile
- icon.png (opens in a new tab)image/png
OSCAR Service Icon
Show content of icon.png
- input.png (opens in a new tab)image/png
Sample input image — Example PNG image for testing the grayscale, edges, and metrics outputs.
Show content of input.png
- sample-images/ (opens in a new tab)
Bundled sample images — Collection of example input images for classroom demonstrations, self-guided testing, and notebook-based analysis.
- Generated output artifactsExpected artifact
Generated output artifacts — Output directory containing <stem>_gray.png, <stem>_edges.png, and <stem>_metrics.json for the uploaded image.
Usage & acceptance tests
Synchronous ImageMagick acceptance test
Run the service directly with the sample image and store the returned ZIP archive containing the generated outputs.
Run the service synchronously with the sample image and store the returned ZIP file.
oscar-cli service run imagemagick --file-input {input} --output {destination}
Asynchronous ImageMagick acceptance test
Upload the sample input image, wait for OSCAR to process it, then download the generated artifacts and confirm that the grayscale PNG, edge PNG, and metrics JSON are present.
Upload the sample input image to the service input path.
oscar-cli service put-file imagemagick {source}Wait for the remote execution to generate the derived image files and metrics JSON.
Time required: PT20SDownload the latest outputs and confirm that the expected files were generated.
oscar-cli service get-file imagemagick --download-latest-into {destination}
RO-Crate metadata
- application/json
Show content of ro-crate-metadata.json