Jpylyzer is a JP2 (JPEG 2000 Part 1) image validator and properties extractor. Its development was partially supported by the SCAPE Project. The SCAPE project is co-funded by the European Union under FP7 ICT-2009.4.1 (Grant Agreement number 270137).
- User Manual – exhaustive documentation of all aspects of jpylyzer
- Windows binaries – stand-alone Windows binaries that allow you to run jpylyzer without any Python dependencies
- Debian packages – i386 (32 bit) architecture
- Debian packages – Amd 64 (64 bit) architecture
Command line use
usage: jpylyzer.py [-h] [--verbose] [--wrapper] [--nullxml] [--nopretty]
... : input JP2 image(s), may be one or more (whitespace-separated) path expressions; prefix wildcard (*) with backslash (\) in Linux..
-h, --help : show this help message and exit;
-v, --version : show program’s version number and exit;
--verbose : report test results in verbose format;
--wrapper, -w : wrap the output for individual image(s) in ‘results’ XML element.
--nullxml : extract null-terminated XML content from XML and UUID boxes (doesn’t affect validation)
--nopretty : suppress pretty-printing of XML output
Output is directed to the standard output device (stdout).
jpylyzer.py rubbish.jp2 > rubbish.xml
In the above example, output is redirected to the file ‘rubbish.xml’.
Outline of output elements
- toolInfo: tool name (jpylyzer) + version.
- fileInfo: name, path, size and last modified time/date of input file.
- isValidJP2: True / False flag indicating whether file is valid JP2.
- tests: tree of test outcomes, expressed as True / False flags.
A file is considered valid JP2 only if all tests return True. Tree follows JP2 box structure. By default only tests that returned False are reported, which results in an empty tests element for files that are valid JP2. Use the
--verboseflag to get all test results.
- properties: tree of image properties. Follows JP2 box structure. Naming of properties follows ISO/IEC 15444-1 Annex I (JP2 file format syntax) and Annex A (Codestream syntax).
Debian packages build process
The Vagrant directory of this repo contains instructions on how to build Debian packages using VirtualBox and Vagrant. A Vagrantfile and provisioning scripts are included for a number of target platforms, which should make the process of building the packages fairly easy.