← Feature overview

VICARIO test procedures

full tier · 2026-11-20 21:46 UTC · commit 39ba569 · passed

Every test in the suite, grouped by feature: what it does, what makes it pass, the kinds of testing it covers, when it was added and last modified, its latest result and the images it read or wrote. Each test links to its run details (commands and logs) and to its source on GitHub.

Tests marked New or Modified are the tests added or changed since release v2.7.2 (published 2026-10-01), from each test's added and modified dates.

Scope of testing

Each test carries one or more scope tags. Click a tag to show only those tests.

Features

VICAR image read/write

Reading and writing VICAR images in every data type (BYTE, HALF, FULL, REAL, DOUB) and organization (BSQ, BIL, BIP), in both byte orders, including degenerate shapes and damaged files.

53 tests · nominal30 off-nominal3 malformed-input5 lossless18 regression10 legacy3 suite3 unit12

  1. byte: BSQ, BIL and BIP decode to the same pixelsNew Passed
    nominalAdded 2026-10-22, modified 2026-10-23

    Decodes the synthetic BYTE image written in each band organization (BSQ, BIL, BIP). Passes when all three decode to the same 48 x 64 x 3 BYTE image (identical pixel hashes).

  2. byte/bsq: VICAR to VICAR round trip keeps type and pixelsNew Passed
    nominallosslessAdded 2026-10-22, modified 2026-10-23

    Converts the synthetic BYTE BSQ image to VICAR with jConvertIIO. Passes when the output label keeps FORMAT='BYTE' and the output pixels are identical to the input.

  3. byte/bil: VICAR to VICAR round trip keeps type and pixelsNew Passed
    nominallosslessAdded 2026-10-22, modified 2026-10-23

    Converts the synthetic BYTE BIL image to VICAR with jConvertIIO. Passes when the output label keeps FORMAT='BYTE' and the output pixels are identical to the input.

  4. byte/bip: VICAR to VICAR round trip keeps type and pixelsNew Passed
    nominallosslessAdded 2026-10-22, modified 2026-10-23

    Converts the synthetic BYTE BIP image to VICAR with jConvertIIO. Passes when the output label keeps FORMAT='BYTE' and the output pixels are identical to the input.

  5. half: BSQ, BIL and BIP decode to the same pixelsNew Passed
    nominalAdded 2026-10-22, modified 2026-10-23

    Decodes the synthetic HALF image written in each band organization (BSQ, BIL, BIP). Passes when all three decode to the same 48 x 64 x 3 SHORT image (identical pixel hashes).

  6. half/bsq: VICAR to VICAR round trip keeps type and pixelsNew Passed
    nominallosslessAdded 2026-10-22, modified 2026-10-23

    Converts the synthetic HALF BSQ image to VICAR with jConvertIIO. Passes when the output label keeps FORMAT='HALF' and the output pixels are identical to the input.

  7. half/bil: VICAR to VICAR round trip keeps type and pixelsNew Passed
    nominallosslessAdded 2026-10-22, modified 2026-10-23

    Converts the synthetic HALF BIL image to VICAR with jConvertIIO. Passes when the output label keeps FORMAT='HALF' and the output pixels are identical to the input.

  8. half/bip: VICAR to VICAR round trip keeps type and pixelsNew Passed
    nominallosslessAdded 2026-10-22, modified 2026-10-23

    Converts the synthetic HALF BIP image to VICAR with jConvertIIO. Passes when the output label keeps FORMAT='HALF' and the output pixels are identical to the input.

  9. full: BSQ, BIL and BIP decode to the same pixelsNew Passed
    nominalAdded 2026-10-22, modified 2026-10-23

    Decodes the synthetic FULL image written in each band organization (BSQ, BIL, BIP). Passes when all three decode to the same 48 x 64 x 3 INT image (identical pixel hashes).

  10. full/bsq: VICAR to VICAR round trip keeps type and pixelsNew Passed
    nominallosslessAdded 2026-10-22, modified 2026-10-23

    Converts the synthetic FULL BSQ image to VICAR with jConvertIIO. Passes when the output label keeps FORMAT='FULL' and the output pixels are identical to the input.

  11. full/bil: VICAR to VICAR round trip keeps type and pixelsNew Passed
    nominallosslessAdded 2026-10-22, modified 2026-10-23

    Converts the synthetic FULL BIL image to VICAR with jConvertIIO. Passes when the output label keeps FORMAT='FULL' and the output pixels are identical to the input.

  12. full/bip: VICAR to VICAR round trip keeps type and pixelsNew Passed
    nominallosslessAdded 2026-10-22, modified 2026-10-23

    Converts the synthetic FULL BIP image to VICAR with jConvertIIO. Passes when the output label keeps FORMAT='FULL' and the output pixels are identical to the input.

  13. real: BSQ, BIL and BIP decode to the same pixelsNew Passed
    nominalAdded 2026-10-22, modified 2026-10-23

    Decodes the synthetic REAL image written in each band organization (BSQ, BIL, BIP). Passes when all three decode to the same 48 x 64 x 3 FLOAT image (identical pixel hashes).

  14. real/bsq: VICAR to VICAR round trip keeps type and pixelsNew Passed
    nominallosslessAdded 2026-10-22, modified 2026-10-23

    Converts the synthetic REAL BSQ image to VICAR with jConvertIIO. Passes when the output label keeps FORMAT='REAL' and the output pixels are identical to the input.

  15. real/bil: VICAR to VICAR round trip keeps type and pixelsNew Passed
    nominallosslessAdded 2026-10-22, modified 2026-10-23

    Converts the synthetic REAL BIL image to VICAR with jConvertIIO. Passes when the output label keeps FORMAT='REAL' and the output pixels are identical to the input.

  16. real/bip: VICAR to VICAR round trip keeps type and pixelsNew Passed
    nominallosslessAdded 2026-10-22, modified 2026-10-23

    Converts the synthetic REAL BIP image to VICAR with jConvertIIO. Passes when the output label keeps FORMAT='REAL' and the output pixels are identical to the input.

  17. doub: BSQ, BIL and BIP decode to the same pixelsNew Passed
    nominalAdded 2026-10-22, modified 2026-10-23

    Decodes the synthetic DOUB image written in each band organization (BSQ, BIL, BIP). Passes when all three decode to the same 48 x 64 x 3 DOUBLE image (identical pixel hashes).

  18. doub/bsq: VICAR to VICAR round trip keeps type and pixelsNew Passed
    nominallosslessAdded 2026-10-22, modified 2026-10-23

    Converts the synthetic DOUB BSQ image to VICAR with jConvertIIO. Passes when the output label keeps FORMAT='DOUB' and the output pixels are identical to the input.

  19. doub/bil: VICAR to VICAR round trip keeps type and pixelsNew Passed
    nominallosslessAdded 2026-10-22, modified 2026-10-23

    Converts the synthetic DOUB BIL image to VICAR with jConvertIIO. Passes when the output label keeps FORMAT='DOUB' and the output pixels are identical to the input.

  20. doub/bip: VICAR to VICAR round trip keeps type and pixelsNew Passed
    nominallosslessAdded 2026-10-22, modified 2026-10-23

    Converts the synthetic DOUB BIP image to VICAR with jConvertIIO. Passes when the output label keeps FORMAT='DOUB' and the output pixels are identical to the input.

  21. degenerate shape gen_byte_ns1_nl1024.vic survives VICAR and PDS round tripsNew Passed
    legacyoff-nominallosslessAdded 2026-10-22, modified 2026-10-23

    Legacy shapes from tstjConvertIIO.csh (1 x 1024, 1024 x 1, REAL 100 x 100): converts gen_byte_ns1_nl1024.vic to VICAR and to PDS3. Passes when both outputs decode to exactly the input pixels.

  22. degenerate shape gen_byte_ns1024_nl1.vic survives VICAR and PDS round tripsNew Passed
    legacyoff-nominallosslessAdded 2026-10-22, modified 2026-10-23

    Legacy shapes from tstjConvertIIO.csh (1 x 1024, 1024 x 1, REAL 100 x 100): converts gen_byte_ns1024_nl1.vic to VICAR and to PDS3. Passes when both outputs decode to exactly the input pixels.

  23. degenerate shape gen_real_100x100.vic survives VICAR and PDS round tripsNew Passed
    legacyoff-nominallosslessAdded 2026-10-22, modified 2026-10-23

    Legacy shapes from tstjConvertIIO.csh (1 x 1024, 1024 x 1, REAL 100 x 100): converts gen_real_100x100.vic to VICAR and to PDS3. Passes when both outputs decode to exactly the input pixels.

  24. jConvertIIO decodes little-endian int16 (INTFMT/REALFMT LOW)New Passed
    nominalAdded 2026-10-22, modified 2026-10-23

    Converts the GDAL int16 fixture, written on a little-endian machine (INTFMT/REALFMT = LOW), to TIFF. Passes when the values read back are the ones stored in the file (1 to 24), so the bytes were swapped correctly.

  25. jConvertIIO decodes little-endian float32-bsq (INTFMT/REALFMT LOW)New Passed
    nominalAdded 2026-10-22, modified 2026-10-23

    Converts the GDAL float32-bsq fixture, written on a little-endian machine (INTFMT/REALFMT = LOW), to TIFF. Passes when the values read back are the ones stored in the file (1 to 122.5), so the bytes were swapped correctly.

  26. little-endian float32 BSQ, BIL and BIP agree after conversionNew Passed
    nominalAdded 2026-10-22, modified 2026-10-23

    Converts the GDAL little-endian float32 fixtures in BSQ, BIL and BIP order to TIFF. Passes when the three TIFFs have identical pixels.

  27. ImageIO API decodes little-endian HALF the same as BYTE 1..24New Passed
    nominalregressionAdded 2026-10-22, modified 2026-10-24

    Reads the GDAL little-endian HALF fixture (values 1 to 24) through the Java ImageIO API rather than jConvertIIO, and compares it with the BYTE fixture holding the same values. Passes when the pixel hashes match.

    Issue REVIEW-1: fixed: VicarImageReader via the ImageIO API returned byte-swapped samples for INTFMT=LOW files (256, 512, ... instead of 1, 2, ...) because the imageio-ext file stream ignores the byte order in its array reads

  28. ImageIO API decodes little-endian int16 the same on every input streamNew Passed
    nominalregressionAdded 2026-10-24

    Reads the GDAL little-endian int16 fixture (INTFMT/REALFMT = LOW) through the Java ImageIO API twice: with the stream ImageIO.createImageInputStream picks (imageio-ext's file stream in the FAT jar) and with the JDK FileImageInputStream. Passes when both give the same pixels and the smallest value is 1, the first value stored in the file.

    Issue REVIEW-1: fixed: the imageio-ext file stream returned byte-swapped HALF/FULL/REAL/DOUB samples for little-endian files

  29. ImageIO API decodes little-endian int32 the same on every input streamNew Passed
    nominalregressionAdded 2026-10-24

    Reads the GDAL little-endian int32 fixture (INTFMT/REALFMT = LOW) through the Java ImageIO API twice: with the stream ImageIO.createImageInputStream picks (imageio-ext's file stream in the FAT jar) and with the JDK FileImageInputStream. Passes when both give the same pixels and the smallest value is 1, the first value stored in the file.

    Issue REVIEW-1: fixed: the imageio-ext file stream returned byte-swapped HALF/FULL/REAL/DOUB samples for little-endian files

  30. ImageIO API decodes little-endian float32-bsq the same on every input streamNew Passed
    nominalregressionAdded 2026-10-24

    Reads the GDAL little-endian float32-bsq fixture (INTFMT/REALFMT = LOW) through the Java ImageIO API twice: with the stream ImageIO.createImageInputStream picks (imageio-ext's file stream in the FAT jar) and with the JDK FileImageInputStream. Passes when both give the same pixels and the smallest value is 1, the first value stored in the file.

    Issue REVIEW-1: fixed: the imageio-ext file stream returned byte-swapped HALF/FULL/REAL/DOUB samples for little-endian files

  31. ImageIO API decodes little-endian float64 the same on every input streamNew Passed
    nominalregressionAdded 2026-10-24

    Reads the GDAL little-endian float64 fixture (INTFMT/REALFMT = LOW) through the Java ImageIO API twice: with the stream ImageIO.createImageInputStream picks (imageio-ext's file stream in the FAT jar) and with the JDK FileImageInputStream. Passes when both give the same pixels and the smallest value is 1, the first value stored in the file.

    Issue REVIEW-1: fixed: the imageio-ext file stream returned byte-swapped HALF/FULL/REAL/DOUB samples for little-endian files

  32. reads bigendian-int16 (system label with DAT_TIM/BINC)New Passed
    malformed-inputregressionAdded 2026-10-22, modified 2026-10-24

    Reads the GDAL bigendian-int16 fixture, whose system label has DAT_TIM and BINC items (a history task whose TASK keyword is missing), through the ImageIO API and converts it to VICAR. Passes when the file decodes to 4 x 3 values from 1 to 24 with mean 12.5 (the same pixels as the well-formed little-endian HALF fixture), jConvertIIO writes VICAR output with the same pixels, and the output keeps the orphaned DAT_TIM in a history task named UNKNOWN.

    Issue REVIEW-2: fixed: VICAR reader rejected labels with DAT_TIM/USER outside a history task ("DAT_TIM may only go in history label") and then failed with a NullPointerException

  33. reads bigendian-float32 (system label with DAT_TIM/BINC)New Passed
    malformed-inputregressionAdded 2026-10-22, modified 2026-10-24

    Reads the GDAL bigendian-float32 fixture, whose system label has DAT_TIM and BINC items (a history task whose TASK keyword is missing), through the ImageIO API and converts it to VICAR. Passes when the file decodes to 4 x 3 values from 1 to 24 with mean 12.5, jConvertIIO writes VICAR output with the same pixels, and the output keeps the orphaned DAT_TIM in a history task named UNKNOWN.

    Issue REVIEW-2: fixed: VICAR reader rejected labels with DAT_TIM/USER outside a history task ("DAT_TIM may only go in history label") and then failed with a NullPointerException

  34. reads vax-float32 (system label with DAT_TIM/BINC)New Passed
    malformed-inputregressionAdded 2026-10-22, modified 2026-10-24

    Reads the GDAL vax-float32 fixture, whose system label has DAT_TIM and BINC items (a history task whose TASK keyword is missing), through the ImageIO API and converts it to VICAR. Passes when the file decodes to 4 x 3 values from 1 to 24 with mean 12.5, jConvertIIO writes VICAR output with the same pixels, and the output keeps the orphaned DAT_TIM in a history task named UNKNOWN.

    Issue REVIEW-2: fixed: VICAR reader rejected labels with DAT_TIM/USER outside a history task ("DAT_TIM may only go in history label") and then failed with a NullPointerException

  35. big-endian and VAX float32 fixtures decode to the same valuesNew Passed
    malformed-inputregressionAdded 2026-10-24

    Reads the GDAL big-endian IEEE and VAX float32 fixtures (both with the misplaced DAT_TIM label item). Passes when the two decode to identical pixels.

    Issue REVIEW-2: fixed: these files could not be opened at all

  36. jConvertIIO decodes little-endian DOUB (float64) and FULL (int32) fixturesNew Passed
    nominalAdded 2026-10-22, modified 2026-10-23

    Converts the GDAL little-endian DOUB (float64) and FULL (int32) fixtures to VICAR. Passes when each output holds the stored values 1 to 24.

  37. binary line prefix fixture decodes to its 1x1 imageNew Passed
    nominalAdded 2026-10-22, modified 2026-10-23

    Reads the GDAL fixture whose image line carries a binary prefix. Passes when it decodes to its 1 x 1 BYTE image (the prefix is not part of the image).

  38. truncated VICAR file fails with a non-zero exitNew Passed
    malformed-inputregressionAdded 2026-10-22, modified 2026-10-23

    Converts a truncated VICAR file (the label promises more data than the file holds). Passes when jConvertIIO exits non-zero and writes no output.

    Issue IDS-8497: fixed: jConvertIIO used to exit 0 after a read failure

  39. malformedLabelFailsWithIIOExceptionForWidthNew Passed
    unitUnit tests (JUnit): VicarImageReaderLabelErrorTestAdded 2026-10-24

    Imports the result of the JUnit test VicarImageReaderLabelErrorTest.malformedLabelFailsWithIIOExceptionForWidth from the Maven build (target/surefire-reports). Passes when it passed in JUnit; a JUnit failure is shown with its message.

  40. malformedLabelFailsWithIIOExceptionNew Passed
    unitUnit tests (JUnit): VicarImageReaderLabelErrorTestAdded 2026-10-24

    Imports the result of the JUnit test VicarImageReaderLabelErrorTest.malformedLabelFailsWithIIOException from the Maven build (target/surefire-reports). Passes when it passed in JUnit; a JUnit failure is shown with its message.

  41. littleEndianFileOnBigEndianStreamNew Passed
    unitUnit tests (JUnit): ImageInputStreamStrideTestAdded 2026-10-24

    Imports the result of the JUnit test ImageInputStreamStrideTest.littleEndianFileOnBigEndianStream from the Maven build (target/surefire-reports). Passes when it passed in JUnit; a JUnit failure is shown with its message.

  42. littleEndianThroughImageioExtStreamNew Passed
    unitUnit tests (JUnit): ImageInputStreamStrideTestAdded 2026-10-24

    Imports the result of the JUnit test ImageInputStreamStrideTest.littleEndianThroughImageioExtStream from the Maven build (target/surefire-reports). Passes when it passed in JUnit; a JUnit failure is shown with its message.

  43. directPathOnlyForStreamsThatHonourByteOrderNew Passed
    unitUnit tests (JUnit): ImageInputStreamStrideTestAdded 2026-10-24

    Imports the result of the JUnit test ImageInputStreamStrideTest.directPathOnlyForStreamsThatHonourByteOrder from the Maven build (target/surefire-reports). Passes when it passed in JUnit; a JUnit failure is shown with its message.

  44. bigEndianThroughImageioExtStreamNew Passed
    unitUnit tests (JUnit): ImageInputStreamStrideTestAdded 2026-10-24

    Imports the result of the JUnit test ImageInputStreamStrideTest.bigEndianThroughImageioExtStream from the Maven build (target/surefire-reports). Passes when it passed in JUnit; a JUnit failure is shown with its message.

  45. littleEndianThroughJdkStreamNew Passed
    unitUnit tests (JUnit): ImageInputStreamStrideTestAdded 2026-10-24

    Imports the result of the JUnit test ImageInputStreamStrideTest.littleEndianThroughJdkStream from the Maven build (target/surefire-reports). Passes when it passed in JUnit; a JUnit failure is shown with its message.

  46. programmaticAddStillRejectsUserInPropertyLabelNew Passed
    unitUnit tests (JUnit): VicarLabelTestAdded 2026-10-24

    Imports the result of the JUnit test VicarLabelTest.programmaticAddStillRejectsUserInPropertyLabel from the Maven build (target/surefire-reports). Passes when it passed in JUnit; a JUnit failure is shown with its message.

  47. readMovesUserOutOfPropertySetNew Passed
    unitUnit tests (JUnit): VicarLabelTestAdded 2026-10-24

    Imports the result of the JUnit test VicarLabelTest.readMovesUserOutOfPropertySet from the Maven build (target/surefire-reports). Passes when it passed in JUnit; a JUnit failure is shown with its message.

  48. testPassed
    unitUnit tests (JUnit): VicarLabelTestAdded 2026-06-18

    Imports the result of the JUnit test VicarLabelTest.test from the Maven build (target/surefire-reports). Passes when it passed in JUnit; a JUnit failure is shown with its message.

  49. programmaticAddStillRejectsDatTimInSystemLabelNew Passed
    unitUnit tests (JUnit): VicarLabelTestAdded 2026-10-24

    Imports the result of the JUnit test VicarLabelTest.programmaticAddStillRejectsDatTimInSystemLabel from the Maven build (target/surefire-reports). Passes when it passed in JUnit; a JUnit failure is shown with its message.

  50. readKeepsOrphanedHistoryItemsInUnknownTaskNew Passed
    unitUnit tests (JUnit): VicarLabelTestAdded 2026-10-24

    Imports the result of the JUnit test VicarLabelTest.readKeepsOrphanedHistoryItemsInUnknownTask from the Maven build (target/surefire-reports). Passes when it passed in JUnit; a JUnit failure is shown with its message.

  51. class is listed under a feature in features.ymlNew Passed
    suiteUnit tests (JUnit): VicarImageReaderLabelErrorTestAdded 2026-10-24

    Bookkeeping, not a product test: checks that the JUnit class jpl.mipl.io.plugins.VicarImageReaderLabelErrorTest is listed in a feature's junit: list in features.yml, so its results are grouped under that feature.

  52. class is listed under a feature in features.ymlNew Passed
    suiteUnit tests (JUnit): ImageInputStreamStrideTestAdded 2026-10-24, modified 2026-10-28

    Bookkeeping, not a product test: checks that the JUnit class jpl.mipl.io.streams.ImageInputStreamStrideTest is listed in a feature's junit: list in features.yml, so its results are grouped under that feature.

  53. class is listed under a feature in features.ymlModified Passed
    suiteUnit tests (JUnit): VicarLabelTestAdded 2026-06-18, modified 2026-10-24

    Bookkeeping, not a product test: checks that the JUnit class jpl.mipl.io.vicar.VicarLabelTest is listed in a feature's junit: list in features.yml, so its results are grouped under that feature.

VICAR binary headers and prefixes

Images with binary label headers and per-line prefixes (NLB/NBB): decoding them, and keeping the prefix bytes when converting to VICAR or PDS (KEEP_LINE_PREFIX, ADD_BINARY_HEADER).

18 tests · nominal1 off-nominal3 lossless9 mission-data8 regression5 suite1 unit6

  1. Cassini ISS image (NLB=1, NBB=24) decodes identically with RI=trueNew Passed
    mission-datalosslessAdded 2026-10-23

    Reads a public Cassini ISS image with a binary label header (NLB=1) and a 24-byte prefix on every line (NBB=24), then converts it to VICAR with RI=true (read as a RenderedImage). Passes when the pixels match the recorded golden hash and the output has the same pixels.

  2. KEEP_LINE_PREFIX=true carries the prefixes into PDS outputNew Passed
    mission-datalosslessAdded 2026-10-23

    Converts the Cassini ISS image to PDS3 with KEEP_LINE_PREFIX=true. Passes when the label declares LINE_PREFIX_BYTES = 24, the first 8 line prefixes are byte for byte those of the input, and the pixels are unchanged.

  3. KEEP_LINE_PREFIX=true carries the prefixes into VICAR outputNew Passed
    mission-datalosslessregressionAdded 2026-10-23, modified 2026-10-24

    Converts the Cassini ISS image to VICAR with KEEP_LINE_PREFIX=true. Passes when the output label has NBB=24, RECSIZE=2072 and the input's BLTYPE/BHOST/BINTFMT/BREALFMT, the first 8 and the last line prefixes are byte for byte those of the input, no binary header is written (NLB=0, the ADD_BINARY_HEADER default), and the pixels are unchanged.

    Issue REVIEW-13: fixed: VICAR output dropped the line prefixes (NBB=0) even with KEEP_LINE_PREFIX=true

  4. VICAR output keeps the line prefixes by defaultNew Passed
    mission-datalosslessregressionAdded 2026-10-23, modified 2026-10-24

    Converts the Cassini ISS image to VICAR without KEEP_LINE_PREFIX, which the help documents as defaulting to true. Passes when the output has NBB=24 and the input's first 8 line prefixes, and the pixels are unchanged.

    Issue REVIEW-13: fixed: the documented KEEP_LINE_PREFIX default (true) was ignored for VICAR output

  5. KEEP_LINE_PREFIX=false strips the prefixes from VICAR outputNew Passed
    mission-datalosslessAdded 2026-10-23, modified 2026-10-24

    Converts the Cassini ISS image to VICAR with KEEP_LINE_PREFIX=false. Passes when the output has NBB=0 and RECSIZE=2048 (1024 HALF samples, no prefix) and the pixels are unchanged.

  6. ADD_BINARY_HEADER=true writes the binary header to VICAR outputNew Passed
    mission-datalosslessregressionAdded 2026-10-23, modified 2026-10-24

    Converts the Cassini ISS image to VICAR with ADD_BINARY_HEADER=true. Passes when the output label has NLB=1, the binary header record is byte for byte the input's, the line prefixes are kept, and the pixels are unchanged.

    Issue REVIEW-13: fixed: VICAR output had no binary header (NLB=0) even with ADD_BINARY_HEADER=true

  7. ADD_BINARY_HEADER=true with KEEP_LINE_PREFIX=false fits the header to the shorter recordsNew Passed
    mission-datalosslessregressionAdded 2026-10-24

    Converts the Cassini ISS image to VICAR with ADD_BINARY_HEADER=true KEEP_LINE_PREFIX=false, so the records shrink from 2072 to 2048 bytes. Passes when the output has NLB=1, NBB=0, RECSIZE=2048, its header record equals the first 2048 bytes of the input's (the 24 bytes cut are all zero), and the pixels are unchanged.

    Issue REVIEW-13: fixed: the binary header was not written to VICAR output

  8. prefixes are not written when SOURCE_REGION drops linesNew Passed
    mission-dataoff-nominalAdded 2026-10-24

    Converts the first 100 lines of the Cassini ISS image to VICAR with SOURCE_REGION=(0,0,1024,100) KEEP_LINE_PREFIX=true. The line prefixes describe 1024 lines, so they can no longer be matched to output lines. Passes when the conversion succeeds with NBB=0, a warning saying the prefixes were not written, and the output is 1024 x 100.

  9. KEEP_LINE_PREFIX and ADD_BINARY_HEADER are harmless without binary dataNew Passed
    off-nominallosslessAdded 2026-10-23, modified 2026-10-24

    Converts a synthetic VICAR image with no prefixes and no binary header to VICAR with KEEP_LINE_PREFIX=true ADD_BINARY_HEADER=true. Passes when the output has NBB=0 and NLB=0 and the pixels are unchanged.

  10. prefixes do not follow the wrong band when BANDS reorders the bandsNew Passed
    off-nominalregressionAdded 2026-10-28

    Converts a synthetic 3-band VICAR image whose line prefixes name their band and line to VICAR with BANDS=(2,1,0) and KEEP_LINE_PREFIX=true. The band count is unchanged but the bands are reversed. Passes when no output record carries a prefix from a different band: either the prefixes are dropped with a warning (NBB=0) or each record's prefix names the input band now in that position.

    Issue REVIEW-13: fixed: with BANDS reordering the bands, the line prefixes were written in the input band order

  11. BANDS that keeps every band in place keeps the prefixesNew Passed
    nominallosslessAdded 2026-10-28

    Converts the same synthetic 3-band prefixed image to VICAR with BANDS=(0,1,2) and KEEP_LINE_PREFIX=true. Passes when the output keeps NBB=4 and every record's prefix is the input's for the same band and line.

  12. headerWithoutPrefixesReblocksWhenDataWouldBeCutNew Passed
    unitUnit tests (JUnit): VicarImageWriterBinaryTestAdded 2026-10-24

    Imports the result of the JUnit test VicarImageWriterBinaryTest.headerWithoutPrefixesReblocksWhenDataWouldBeCut from the Maven build (target/surefire-reports). Passes when it passed in JUnit; a JUnit failure is shown with its message.

  13. noParamWritesNoBinaryDataNew Passed
    unitUnit tests (JUnit): VicarImageWriterBinaryTestAdded 2026-10-24

    Imports the result of the JUnit test VicarImageWriterBinaryTest.noParamWritesNoBinaryData from the Maven build (target/surefire-reports). Passes when it passed in JUnit; a JUnit failure is shown with its message.

  14. dropsPrefixesWhenLineCountChangedNew Passed
    unitUnit tests (JUnit): VicarImageWriterBinaryTestAdded 2026-10-24

    Imports the result of the JUnit test VicarImageWriterBinaryTest.dropsPrefixesWhenLineCountChanged from the Maven build (target/surefire-reports). Passes when it passed in JUnit; a JUnit failure is shown with its message.

  15. keepsPrefixesAndHeaderNew Passed
    unitUnit tests (JUnit): VicarImageWriterBinaryTestAdded 2026-10-24

    Imports the result of the JUnit test VicarImageWriterBinaryTest.keepsPrefixesAndHeader from the Maven build (target/surefire-reports). Passes when it passed in JUnit; a JUnit failure is shown with its message.

  16. keepsPrefixesOnlyNew Passed
    unitUnit tests (JUnit): VicarImageWriterBinaryTestAdded 2026-10-24

    Imports the result of the JUnit test VicarImageWriterBinaryTest.keepsPrefixesOnly from the Maven build (target/surefire-reports). Passes when it passed in JUnit; a JUnit failure is shown with its message.

  17. headerWithoutPrefixesTruncatesZeroTailNew Passed
    unitUnit tests (JUnit): VicarImageWriterBinaryTestAdded 2026-10-24

    Imports the result of the JUnit test VicarImageWriterBinaryTest.headerWithoutPrefixesTruncatesZeroTail from the Maven build (target/surefire-reports). Passes when it passed in JUnit; a JUnit failure is shown with its message.

  18. class is listed under a feature in features.ymlNew Passed
    suiteUnit tests (JUnit): VicarImageWriterBinaryTestAdded 2026-10-24

    Bookkeeping, not a product test: checks that the JUnit class jpl.mipl.io.plugins.VicarImageWriterBinaryTest is listed in a feature's junit: list in features.yml, so its results are grouped under that feature.

PDS3 products

Reading PDS3 products (attached and detached labels, dual PDS3/VICAR labels) and writing PDS3 with an embedded VICAR label, file name in the label, or ODL3 labels.

23 tests · nominal5 off-nominal1 lossless7 mission-data8 regression6 legacy1 suite2 unit7

  1. VICAR to PDS3 writes a valid label and keeps pixelsNew Passed
    nominallosslessAdded 2026-10-22, modified 2026-10-23

    Converts the synthetic 3-band BYTE image to PDS3. Passes when the label is valid (PDS3 version, ^IMAGE pointer, an IMAGE object with the right LINES, LINE_SAMPLES and BANDS, no empty "" values) and the pixels are unchanged.

  2. EMBED_VICAR_LABEL=true embeds the VICAR labelNew Passed
    nominallosslessAdded 2026-10-22, modified 2026-10-23

    Converts the synthetic image to PDS3 with EMBED_VICAR_LABEL=true. Passes when the PDS3 label is valid, the VICAR label (LBLSIZE=) is embedded in the file, and the pixels are unchanged.

  3. PDS_FILENAME_IN_LABEL=true puts the output file name in the labelNew Passed
    nominalregressionlosslessAdded 2026-10-22, modified 2026-10-24

    Converts the synthetic image to PDS3 with PDS_FILENAME_IN_LABEL=true. Passes when the label is valid, its ^IMAGE pointer names the output file by its base name (^IMAGE = ("named.pds",n)) and the pixels are unchanged.

    Issue REVIEW-9: fixed: the documented keyword PDS_FILENAME_IN_LABEL was parsed as PDS_FILENAME and ignored, and the writer never put the file name in the label

  4. PDS_FILENAME (older spelling) still puts the file name in the labelNew Passed
    nominalregressionAdded 2026-10-24

    Converts the synthetic image to PDS3 with PDS_FILENAME=true, the only spelling the parser accepted before. Passes when the ^IMAGE pointer names the output file.

    Issue REVIEW-9: PDS_FILENAME is kept as an alias of PDS_FILENAME_IN_LABEL

  5. without PDS_FILENAME_IN_LABEL, or with =false, the label names no fileNew Passed
    off-nominalregressionAdded 2026-10-22, modified 2026-10-24

    Converts the synthetic image to PDS3 without the keyword, and again with PDS_FILENAME_IN_LABEL=false. Passes when both labels use the record-number pointer ^IMAGE = n and do not contain the output file name.

    Issue REVIEW-9: the file name is opt-in; the default attached label is unchanged

  6. PDS_LABEL_TYPE=ODL3 writes an ODL3 labelNew Passed
    nominalAdded 2026-10-22, modified 2026-10-23

    Converts the synthetic image to PDS3 with PDS_LABEL_TYPE=ODL3. Passes when the label starts with ODL_VERSION_ID = ODL3 and is otherwise valid.

  7. reads an MSL Navcam EDR thumbnail (attached PDS3 + VICAR labels)New Passed
    mission-datalosslessAdded 2026-10-22, modified 2026-10-23

    Reads a public MSL Navcam EDR thumbnail, which carries both a PDS3 and a VICAR label, and converts it to VICAR. Passes when the pixels match the recorded golden hash and the VICAR output has the same pixels.

  8. reads an MSL Navcam EDR through its detached .LBLNew Passed
    mission-dataregressionlosslessAdded 2026-10-22, modified 2026-10-24

    Converts the same MSL thumbnail by giving jConvertIIO its detached .LBL label instead of the image file. Passes when the conversion succeeds and the VICAR output has the same pixels as the .IMG.

    Issue REVIEW-7: fixed: the embedded VICAR label (^IMAGE_HEADER in the .IMG) was read from the .LBL before the data file was opened, and seeking past the end of the .LBL failed with "Negative size"

  9. namespaced PDS3 keywords (MSL:...) become legal VICAR keywordsNew Passed
    mission-dataregressionAdded 2026-10-22, modified 2026-10-24

    Converts the MSL thumbnail's detached .LBL, which uses namespaced keywords such as MSL:MODEL_TRANSFORM_VECTOR, to VICAR. Passes when no VICAR keyword contains :, the namespace is dropped (MODEL_TRANSFORM_VECTOR= is present, as in the mission's own VICAR label) and the output reads back with the .IMG pixels.

    Issue NEW-pds3-2: fixed: MSL:... keywords were copied verbatim into the VICAR label, which vicario then could not read back ("'=' expected after label keyword 'MSL'")

  10. PDS-labelled input to FORMAT=pds with the default stylesheetNew Passed
    mission-dataregressionAdded 2026-10-22, modified 2026-10-23

    Converts a PDS-labelled MSL image to PDS3 (FORMAT=pds) without a stylesheet, so the default PDS-to-PDS stylesheet is used. Passes when the conversion succeeds with a non-empty output; before the IDS-8497 fix it crashed and left an empty file.

    Issue IDS-8497: fixed: the default PDS-to-PDS stylesheet name was empty (NullPointerException, empty .pds)

  11. PDS-labelled input to FORMAT=pds with an explicit copy stylesheetNew Passed
    mission-datalosslessAdded 2026-10-22, modified 2026-10-23

    Same conversion with XSL=CopyEverything.xsl given explicitly. Passes when the output label has an ^IMAGE pointer and the pixels are unchanged.

    Issue IDS-8497: an explicit copy stylesheet gives the same result as the default

  12. MSL Navcam full EDR reads and round-trips through VICARNew Passed
    mission-datalosslessPDS3 products (full-size products)Added 2026-10-22, modified 2026-10-23

    Reads a full-size public MSL Navcam EDR and converts it to VICAR. Passes when the pixels match the recorded golden hash and the VICAR output has the same pixels.

  13. MER Opportunity Navcam EDR reads (stand-in for the legacy mer_file.vic)New Passed
    mission-datalegacyPDS3 products (full-size products)Added 2026-10-22, modified 2026-10-23

    Reads a public MER Opportunity Navcam EDR, the public stand-in for the internal mer_file.vic of the legacy test. Passes when the pixels match the recorded golden hash.

  14. Cassini ISS: VICAR image and its detached PDS3 label decode identicallyNew Passed
    mission-dataPDS3 products (full-size products)Added 2026-10-22, modified 2026-10-23

    Reads a public Cassini ISS image directly and through its detached PDS3 label (.lbl, whose ^IMAGE points at the image). Passes when both match the recorded golden hash.

  15. fileChannelStreamSeekPastEndReadsEofNew Passed
    unitUnit tests (JUnit): PDS3DetachedLabelTestAdded 2026-10-24

    Imports the result of the JUnit test PDS3DetachedLabelTest.fileChannelStreamSeekPastEndReadsEof from the Maven build (target/surefire-reports). Passes when it passed in JUnit; a JUnit failure is shown with its message.

  16. headerPointerAtStartOfDataFileKeepsVicarLabelNew Passed
    unitUnit tests (JUnit): PDS3DetachedLabelTestAdded 2026-10-24

    Imports the result of the JUnit test PDS3DetachedLabelTest.headerPointerAtStartOfDataFileKeepsVicarLabel from the Maven build (target/surefire-reports). Passes when it passed in JUnit; a JUnit failure is shown with its message.

  17. headerPointerPastEndOfLabelFileNew Passed
    unitUnit tests (JUnit): PDS3DetachedLabelTestAdded 2026-10-24

    Imports the result of the JUnit test PDS3DetachedLabelTest.headerPointerPastEndOfLabelFile from the Maven build (target/surefire-reports). Passes when it passed in JUnit; a JUnit failure is shown with its message.

  18. noImageObjectProducesEmptySystemLabelPassed
    unitUnit tests (JUnit): PDS3ObjectNameTestAdded 2026-05-27

    Imports the result of the JUnit test PDS3ObjectNameTest.noImageObjectProducesEmptySystemLabel from the Maven build (target/surefire-reports). Passes when it passed in JUnit; a JUnit failure is shown with its message.

  19. readsRflImageWithExplicitParamPassed
    unitUnit tests (JUnit): PDS3ObjectNameTestAdded 2026-05-27

    Imports the result of the JUnit test PDS3ObjectNameTest.readsRflImageWithExplicitParam from the Maven build (target/surefire-reports). Passes when it passed in JUnit; a JUnit failure is shown with its message.

  20. readsRflImageViaHeuristicWhenParamUnsetPassed
    unitUnit tests (JUnit): PDS3ObjectNameTestAdded 2026-05-27

    Imports the result of the JUnit test PDS3ObjectNameTest.readsRflImageViaHeuristicWhenParamUnset from the Maven build (target/surefire-reports). Passes when it passed in JUnit; a JUnit failure is shown with its message.

  21. readsStandardImageObjectPassed
    unitUnit tests (JUnit): PDS3ObjectNameTestAdded 2026-05-27

    Imports the result of the JUnit test PDS3ObjectNameTest.readsStandardImageObject from the Maven build (target/surefire-reports). Passes when it passed in JUnit; a JUnit failure is shown with its message.

  22. class is listed under a feature in features.ymlNew Passed
    suiteUnit tests (JUnit): PDS3DetachedLabelTestAdded 2026-10-24

    Bookkeeping, not a product test: checks that the JUnit class jpl.mipl.io.vicar.PDS3DetachedLabelTest is listed in a feature's junit: list in features.yml, so its results are grouped under that feature.

  23. class is listed under a feature in features.ymlPassed
    suiteUnit tests (JUnit): PDS3ObjectNameTestAdded 2026-05-27

    Bookkeeping, not a product test: checks that the JUnit class jpl.mipl.io.vicar.PDS3ObjectNameTest is listed in a feature's junit: list in features.yml, so its results are grouped under that feature.

PDS label transcoding (XSL)

Building PDS labels from VICAR labels with the bundled XSL stylesheets, the default stylesheet (XSL=-) and the legacy mission recipes.

5 tests · nominal3 off-nominal1 lossless3 mission-data2 regression1 legacy3

  1. XSL=- uses the default stylesheet from the jarNew Passed
    nominallosslessAdded 2026-10-22, modified 2026-10-23

    Converts the synthetic image to PDS3 with XSL=- (the default stylesheet in the jar) and EMBED_VICAR_LABEL=true. Passes when the label is valid and the pixels are unchanged.

  2. legacy recipe: XML=false, VicarToPDSmer1.xsl, EMBED_VICAR_LABEL=trueNew Passed
    legacynominalAdded 2026-10-22, modified 2026-10-23

    The legacy normal.pds recipe from tstjConvertIIO.csh (XML=false, XSL=VicarToPDSmer1.xsl, EMBED_VICAR_LABEL=true) on the synthetic image. Passes when the PDS3 label is valid.

  3. all 23 bundled VicarToPDS stylesheets produce valid labelsNew Passed
    nominallosslessAdded 2026-10-22, modified 2026-10-23

    Converts the synthetic image to PDS3 with each of the 23 VicarToPDS stylesheets in the jar, one step per stylesheet. Passes when every label is valid and every output has the input pixels.

  4. legacy normal.pds recipe on a public MER EDR (via VICAR)New Passed
    legacymission-datalosslessPDS label transcoding (XSL) (mission products)Added 2026-10-22, modified 2026-10-23

    The legacy normal.pds recipe on real data: converts a public MER EDR to VICAR, then to PDS3 with VicarToPDSmer1.xsl. Passes when the label is valid for a 512 x 512 image and the pixels match the original EDR.

  5. VICAR-to-PDS stylesheet on a PDS-labelled MER EDRNew Passed
    legacymission-dataoff-nominalregressionPDS label transcoding (XSL) (mission products)Added 2026-10-22, modified 2026-10-23

    Applies a VICAR-to-PDS stylesheet directly to a PDS-labelled MER EDR (the legacy mer_file.vic case in runAll.csh). Passes when the conversion succeeds, copying the input label with a warning; before the IDS-8497 fix it crashed.

    Issue IDS-8497: fixed: a VICAR-to-PDS stylesheet on PDS-labelled input (the legacy mer_file.vic case) crashed; the input label is now copied with a warning

PDS4 images

Reading images through PDS4 XML labels; the PDS4 view must match the attached-label view of the same data.

4 tests · nominal1 lossless2 mission-data4

  1. PDS4 label and attached label decode the same pixelsNew Passed
    mission-dataAdded 2026-10-22, modified 2026-10-23

    Reads a public Mars 2020 Navcam thumbnail two ways: through its PDS4 XML label and directly through the label attached to the image. Passes when the PDS4 reader is used and both give identical pixels matching the recorded golden hash.

  2. jConvertIIO converts a PDS4 label to TIFF and VICARNew Passed
    mission-datalosslessAdded 2026-10-22, modified 2026-10-23

    Converts the Mars 2020 thumbnail to TIFF and to VICAR, giving jConvertIIO the PDS4 label as input. Passes when both outputs have the pixels the label decodes to.

  3. a relative PDS4 label path resolves its data file next to the labelNew Passed
    mission-datanominalAdded 2026-10-22, modified 2026-10-23

    Runs jConvertIIO from a parent directory with a relative path to the PDS4 label. Passes when the data file is found next to the label and the TIFF has the expected pixels.

  4. Mars 2020 Navcam full EDR via PDS4 labelNew Passed
    mission-datalosslessPDS4 images (full-size products)Added 2026-10-22, modified 2026-10-23

    Reads a full-size public Mars 2020 Navcam EDR through its PDS4 label and directly, then converts it to VICAR. Passes when all three decode to identical pixels matching the recorded golden hash.

PDS4 tables

Exporting PDS4 tables (character, delimited) as CSV or fixed-width text, with the bundled ExtractTableJPL tool and jConvertIIO's PDS4_TABLE_* keywords.

17 tests · nominal12 off-nominal5 regression13

  1. character table to CSV: header plus every record, values intactNew Passed
    nominalAdded 2026-10-23, modified 2026-10-26

    Exports a PDS4 character table (GDAL fixture: 22 fields, 5 records) to CSV with ExtractTableJPL -c. Passes when the CSV has a 22-column header including "Event Number" and every record's values equal the source table.

  2. character table to fixed-width textNew Passed
    nominalAdded 2026-10-23, modified 2026-10-26

    Exports the same table to fixed-width text with ExtractTableJPL -w. Passes when there is a header plus 5 records and the first record's values equal the source.

  3. without -o the table is written to stdoutNew Passed
    off-nominalregressionAdded 2026-10-23, modified 2026-10-26

    Runs ExtractTableJPL -c without -o. Passes when exit is 0 and stdout holds the CSV table: a 22-column header including "Event Number" and every record's values equal the source.

    Issue REVIEW-15: fixed: without -o the table went to an internal buffer that main() never printed, so nothing came out

  4. --list-tables without -o lists the table and its fields on stdoutNew Passed
    nominalregressionAdded 2026-10-23, modified 2026-10-26

    Runs ExtractTableJPL --list-tables without -o on the character table. Passes when exit is 0 and stdout names table 1 as a fixed-width character table followed by its 22 fields, the first being "Event Number".

    Issue REVIEW-15: fixed: --list-tables without -o printed nothing

  5. -h prints the usage and exits 0New Passed
    nominalregressionAdded 2026-10-26

    Runs ExtractTableJPL -h. Passes when exit is 0, stdout holds the usage text (including the --output-file option) and there is no exception.

    Issue NEW-pds4-1: fixed: showHelp did not exit, so -h fell through and ended in ArrayIndexOutOfBoundsException

  6. no label file: usage message and a non-zero exitNew Passed
    off-nominalregressionAdded 2026-10-23, modified 2026-10-26

    Runs ExtractTableJPL -c with no label file. Passes when exit is non-zero, stderr says "A label file is required", the usage text is printed and there is no exception.

    Issue NEW-pds4-1: fixed: a missing label file printed the usage and then crashed with ArrayIndexOutOfBoundsException

  7. delimited (CSV) tableNew Known issue
    nominalAdded 2026-10-23, modified 2026-11-03

    Exports a PDS4 delimited (CSV) table (GDAL fixture: 4 fields, 10 records) with ExtractTableJPL -c. A known issue (IDS-10429): expected to fail until this build can read delimited tables. Passes when the output has a header naming AREA, EAS_ID, PRFEDEA and WKT plus 10 records whose first three values equal the source CSV.

    Issue IDS-10429: PDS4 delimited (CSV) tables: pds4-jparser 2.12.1 calls CSVParserBuilder.withKeepQuotations, which exists only in the unpublished gov.nasa.pds:opencsv fork, not in public opencsv; fixing it needs a dependency/JDK-baseline decision (pds4-jparser 3.x needs Java 17 and bundles an old copy of vicario)

  8. delimited table: clean "not supported in this build" errorNew Passed
    off-nominalregressionAdded 2026-10-23, modified 2026-10-26

    Exports the delimited (CSV) table with ExtractTableJPL -c and through jConvertIIO, which this build cannot read (REVIEW-16). Passes when both exit non-zero and say "delimited PDS4 tables are not supported in this build", and neither prints a NoSuchMethodError stack trace.

    Issue REVIEW-16: fixed: the missing opencsv method crashed the tool with a raw NoSuchMethodError stack trace instead of a clear error

  9. jConvertIIO PDS4_TABLE_OUTPUT_FORMAT=csv exports the tableNew Passed
    nominalregressionAdded 2026-10-26

    Exports the character table through jConvertIIO with PDS4_TABLE_OUTPUT_FORMAT=csv. Passes when exit is 0 and the out= file holds a 22-column CSV header including "Event Number" plus 5 records whose values equal the source.

    Issue REVIEW-17: fixed: jConvertIIO stopped with "Cannot read label file" on every PDS4 table, because the reader ran ExtractTableJPL with no label while probing the file

  10. jConvertIIO accepts the old PDS4_TABLE_OUPUT_FORMAT spellingNew Passed
    off-nominalregressionAdded 2026-10-26

    Exports the character table through jConvertIIO with PDS4_TABLE_OUPUT_FORMAT=csv, the misspelling earlier HELP text documented. Passes when exit is 0 and the out= file is CSV (22-column header, 5 records equal to the source), so the keyword took effect rather than being ignored.

    Issue REVIEW-17: fixed: HELP documented PDS4_TABLE_OUPUT_FORMAT but only PDS4_TABLE_OUTPUT_FORMAT was accepted; both are now

  11. jConvertIIO PDS4_TABLE_OUTPUT_FORMAT=fixed-width exports fixed-width textNew Passed
    nominalregressionAdded 2026-10-26

    Exports the character table through jConvertIIO with PDS4_TABLE_OUTPUT_FORMAT=fixed-width. Passes when exit is 0 and the out= file has a header plus 5 records, no commas, and every record's values equal the source.

    Issue REVIEW-17: fixed: jConvertIIO could not export any PDS4 table

  12. jConvertIIO table export defaults to fixed-width, as HELP documentsNew Passed
    nominalregressionAdded 2026-10-26

    Exports the character table through jConvertIIO with no PDS4_TABLE_OUTPUT_FORMAT. Passes when exit is 0 and the out= file is fixed-width text (no commas, header plus 5 records equal to the source), the default HELP documents.

    Issue REVIEW-17: fixed: HELP says the default is fixed-width but jConvertIIO defaulted to csv

  13. jConvertIIO PDS4_TABLE_LIST=true lists the tables and fieldsNew Passed
    nominalregressionAdded 2026-10-26

    Runs jConvertIIO with PDS4_TABLE_LIST=true on the character table. Passes when exit is 0 and the out= file names table 1 as a fixed-width character table followed by its 22 fields.

    Issue REVIEW-17: fixed: jConvertIIO could not export or list any PDS4 table

  14. jConvertIIO PDS4_TABLE_FIELDS selects fieldsNew Passed
    nominalAdded 2026-10-23, modified 2026-10-26

    Exports the character table through jConvertIIO with PDS4_TABLE_OUTPUT_FORMAT=csv and PDS4_TABLE_FIELDS=1,3. Passes when exit is 0 and the CSV has a 2-column header "Event Number,Day of Year" and every record holds source fields 1 and 3.

  15. jConvertIIO PDS4_TABLE_INDEX selects the second tableNew Passed
    nominalregressionAdded 2026-10-26

    Builds a two-table product from the character table (table 2 covers records 3-5 of the same file) and exports it through jConvertIIO with PDS4_TABLE_INDEX=2 PDS4_TABLE_OUTPUT_FORMAT=csv. Passes when exit is 0 and the CSV has the 22-column header plus exactly 3 records equal to source records 3-5.

    Issue NEW-pds4-2: fixed: PDS4_TABLE_INDEX was parsed but never passed to the extractor, so table 1 was always exported

  16. jConvertIIO TABLE_FIELD_SEPARATOR sets the field separatorNew Passed
    nominalregressionAdded 2026-10-26

    Exports the character table through jConvertIIO with PDS4_TABLE_OUTPUT_FORMAT=csv TABLE_FIELD_SEPARATOR=|. Passes when exit is 0, the output has no commas, and splitting on "|" gives a 22-column header plus 5 records equal to the source.

    Issue NEW-pds4-3: fixed: only a comma was ever passed on as the field separator; any other TABLE_FIELD_SEPARATOR was ignored

  17. reading a PDS4 table label logs no XPath namespace errorNew Passed
    off-nominalregressionAdded 2026-10-23, modified 2026-10-26

    Exports the character table (its label binds the PDS namespace as the default namespace, with no "pds:" prefix) through jConvertIIO. Passes when exit is 0, the output is written and the log has no "Prefix must resolve to a namespace" error or other exception.

    Issue NEW-pds4-4: fixed: labels that do not declare the "pds" prefix logged an XPathExpressionException on every read

ISIS cubes

Reading ISIS2 cubes with SFDU labels, such as Cassini VIMS spectral cubes (ISIS3 cubes are not supported).

7 tests · nominal2 off-nominal1 malformed-input1 mission-data1 regression3 suite1 unit3

  1. reads the Cassini VIMS cube and converts it to VICARNew Passed
    nominalregressionmission-dataAdded 2026-10-23, modified 2026-10-24

    Converts the Cassini VIMS cube to VICAR. Passes when the output has the dimensions and data type given by the label's CORE_ITEMS (1 x 64 x 352, SHORT).

    Issue REVIEW-14: fixed: CORE_ITEMS / SUFFIX_ITEMS values with blanks (" 352", "1 ") were not trimmed (NumberFormatException, then a NullPointerException and no output)

    Issue NEW-isis-1: fixed: both the ISIS and the PDS reader accept an ISIS2 qube and ImageIO picked either; when the PDS reader won, the output was a 1x1x1 BYTE image

  2. reads the GDAL ISIS2 cube and converts it to VICARNew Passed
    nominalregressionAdded 2026-10-23, modified 2026-10-24

    Converts the GDAL ISIS2 cube to VICAR. Passes when the output has the dimensions and data type given by the label's CORE_ITEMS (43 x 1 x 1, FLOAT).

    Issue REVIEW-14: fixed: CORE_ITEMS / SUFFIX_ITEMS values with blanks (" 352", "1 ") were not trimmed (NumberFormatException, then a NullPointerException and no output)

    Issue NEW-isis-1: fixed: both the ISIS and the PDS reader accept an ISIS2 qube and ImageIO picked either; when the PDS reader won, the output was a 1x1x1 BYTE image

  3. a cube whose CORE_ITEMS is not a list of integers fails with a clear errorNew Passed
    off-nominalmalformed-inputregressionAdded 2026-10-24

    Copies the GDAL ISIS2 cube with CORE_ITEMS = (43,1 ,1) changed to (43,x ,1) and converts it to VICAR. Passes when jConvertIIO exits non-zero and reports that the ISIS reader cannot read the label, without a NullPointerException.

    Issue REVIEW-14: fixed: a header the ISIS reader could not parse was only printed, and the read then failed later with a NullPointerException

  4. cachedStreamIsNotRandomAccessEasyNew Passed
    unitUnit tests (JUnit): ReaderSelectionTestAdded 2026-10-24

    Imports the result of the JUnit test ReaderSelectionTest.cachedStreamIsNotRandomAccessEasy from the Maven build (target/surefire-reports). Passes when it passed in JUnit; a JUnit failure is shown with its message.

  5. isisReaderIsOfferedBeforePdsReaderNew Passed
    unitUnit tests (JUnit): ReaderSelectionTestAdded 2026-10-24

    Imports the result of the JUnit test ReaderSelectionTest.isisReaderIsOfferedBeforePdsReader from the Maven build (target/surefire-reports). Passes when it passed in JUnit; a JUnit failure is shown with its message.

  6. seekableFileStreamsAreRandomAccessNew Passed
    unitUnit tests (JUnit): ReaderSelectionTestAdded 2026-10-24

    Imports the result of the JUnit test ReaderSelectionTest.seekableFileStreamsAreRandomAccess from the Maven build (target/surefire-reports). Passes when it passed in JUnit; a JUnit failure is shown with its message.

  7. class is listed under a feature in features.ymlNew Passed
    suiteUnit tests (JUnit): ReaderSelectionTestAdded 2026-10-24, modified 2026-10-28

    Bookkeeping, not a product test: checks that the JUnit class jpl.mipl.io.plugins.ReaderSelectionTest is listed in a feature's junit: list in features.yml, so its results are grouped under that feature.

FITS images

Reading FITS images and converting them to other formats.

1 tests · lossless1 mission-data1

  1. reads HorseHead.fits and converts it to VICAR and TIFFNew Passed
    mission-datalosslessAdded 2026-10-22, modified 2026-10-23

    Reads the public HorseHead.fits (astropy sample data) and converts it to VICAR and TIFF. jConvertIIO flips FITS rows into display order, so outputs are compared with the source by statistics and with each other by pixels. Passes when the source matches the recorded golden hash, both outputs have the source's size, type and statistics, and the two outputs are identical.

    Note: jConvertIIO flips FITS (bottom-up rows) to top-down display order; the ImageIO reader returns storage order, so outputs are compared with each other and by statistics

Magellan products

Reading Magellan F-BIDR radar image strips (full-resolution basic image data records). The resampled format (MgnResampImageReader) has no public sample and is not tested.

2 tests · lossless1 mission-data2 regression2

  1. F-BIDR reader decodes the orbit 378 image stripNew Passed
    mission-dataregressionAdded 2026-10-23, modified 2026-10-24

    Reads a public Magellan F-BIDR (orbit 378, file 13) with the F-BIDR ImageIO reader, once through a plain FileImageInputStream and once through the stream ImageIO picks by default. Passes when both decode to a 1092 x 14672 BYTE image that is not blank and matches the recorded golden hash.

    Issue REVIEW-18: fixed: only a javax FileImageInputStream counted as random access, so the default stream was refused

  2. jConvertIIO converts the F-BIDR to VICARNew Passed
    mission-dataregressionlosslessAdded 2026-10-23, modified 2026-10-24

    Converts the same F-BIDR to VICAR with jConvertIIO. Passes when the output decodes to the golden pixels (1092 x 14672 BYTE, all 14672 lines).

    Issue REVIEW-18: fixed: the F-BIDR reader refused jConvertIIO's seekable FileChannelImageInputStream ("must be read from a stream allowing random access") because VicarInputFile only treated a javax FileImageInputStream as random access

Output formats

Every FORMAT= name and alias used by the legacy test (TIFF, PNG, JPEG/JFIF, JPEG 2000, BMP, PNM, RAW, PDS, VICAR), for 8-bit, 16-bit and float images. The legacy test also listed ISIS, JPEG-LS and JPEG-LOSSLESS; those tests are skipped because this build has no writer for them. RAW is headerless band-sequential; PNM is written by vicario's own PGM/PPM writer. TIFF output can be read back as input.

60 tests · nominal26 off-nominal15 lossless36 regression18 legacy29 suite1 unit4

  1. FORMAT=tif (#01)New Passed
    legacylosslessAdded 2026-10-22, modified 2026-11-03

    Converts the synthetic 3-band BYTE image with FORMAT=tif, one of the 29 format names and aliases in the legacy test. Passes when the output decodes to exactly the input pixels.

  2. FORMAT=tiff (#02)New Passed
    legacylosslessAdded 2026-10-22, modified 2026-11-03

    Converts the synthetic 3-band BYTE image with FORMAT=tiff, one of the 29 format names and aliases in the legacy test. Passes when the output decodes to exactly the input pixels.

  3. FORMAT=TIF (#03)New Passed
    legacylosslessAdded 2026-10-22, modified 2026-11-03

    Converts the synthetic 3-band BYTE image with FORMAT=TIF, one of the 29 format names and aliases in the legacy test. Passes when the output decodes to exactly the input pixels.

  4. FORMAT=TIFF (#04)New Passed
    legacylosslessAdded 2026-10-22, modified 2026-11-03

    Converts the synthetic 3-band BYTE image with FORMAT=TIFF, one of the 29 format names and aliases in the legacy test. Passes when the output decodes to exactly the input pixels.

  5. FORMAT=png (#05)New Passed
    legacylosslessAdded 2026-10-22, modified 2026-11-03

    Converts the synthetic 3-band BYTE image with FORMAT=png, one of the 29 format names and aliases in the legacy test. Passes when the output decodes to exactly the input pixels.

  6. FORMAT=PNG (#06)New Passed
    legacylosslessAdded 2026-10-22, modified 2026-11-03

    Converts the synthetic 3-band BYTE image with FORMAT=PNG, one of the 29 format names and aliases in the legacy test. Passes when the output decodes to exactly the input pixels.

  7. FORMAT=jpeg2000 (#07)New Passed
    legacylosslessAdded 2026-10-22, modified 2026-11-03

    Converts the synthetic 3-band BYTE image with FORMAT=jpeg2000, one of the 29 format names and aliases in the legacy test. Passes when the output decodes to exactly the input pixels.

  8. FORMAT=JPEG2000 (#08)New Passed
    legacylosslessAdded 2026-10-22, modified 2026-11-03

    Converts the synthetic 3-band BYTE image with FORMAT=JPEG2000, one of the 29 format names and aliases in the legacy test. Passes when the output decodes to exactly the input pixels.

  9. FORMAT=JPEG 2000 (#09)New Passed
    legacylosslessAdded 2026-10-22, modified 2026-11-03

    Converts the synthetic 3-band BYTE image with FORMAT=JPEG 2000, one of the 29 format names and aliases in the legacy test. Passes when the output decodes to exactly the input pixels.

  10. FORMAT=jpeg 2000 (#10)New Passed
    legacylosslessAdded 2026-10-22, modified 2026-11-03

    Converts the synthetic 3-band BYTE image with FORMAT=jpeg 2000, one of the 29 format names and aliases in the legacy test. Passes when the output decodes to exactly the input pixels.

  11. FORMAT=pds (#11)New Passed
    legacylosslessAdded 2026-10-22, modified 2026-11-03

    Converts the synthetic 3-band BYTE image with FORMAT=pds, one of the 29 format names and aliases in the legacy test. Passes when the output decodes to exactly the input pixels.

  12. FORMAT=vicar (#12)New Passed
    legacylosslessAdded 2026-10-22, modified 2026-11-03

    Converts the synthetic 3-band BYTE image with FORMAT=vicar, one of the 29 format names and aliases in the legacy test. Passes when the output decodes to exactly the input pixels.

  13. FORMAT=jpg (#13)New Passed
    legacynominalAdded 2026-10-22, modified 2026-11-03

    Converts the synthetic 3-band BYTE image with FORMAT=jpg, one of the 29 format names and aliases in the legacy test. Passes when the output has the input's size and bands and its mean is within 2 DN of the input (JPEG is lossy).

  14. FORMAT=JPG (#14)New Passed
    legacynominalAdded 2026-10-22, modified 2026-11-03

    Converts the synthetic 3-band BYTE image with FORMAT=JPG, one of the 29 format names and aliases in the legacy test. Passes when the output has the input's size and bands and its mean is within 2 DN of the input (JPEG is lossy).

  15. FORMAT=jpeg (#15)New Passed
    legacynominalAdded 2026-10-22, modified 2026-11-03

    Converts the synthetic 3-band BYTE image with FORMAT=jpeg, one of the 29 format names and aliases in the legacy test. Passes when the output has the input's size and bands and its mean is within 2 DN of the input (JPEG is lossy).

  16. FORMAT=JPEG (#16)New Passed
    legacynominalAdded 2026-10-22, modified 2026-11-03

    Converts the synthetic 3-band BYTE image with FORMAT=JPEG, one of the 29 format names and aliases in the legacy test. Passes when the output has the input's size and bands and its mean is within 2 DN of the input (JPEG is lossy).

  17. FORMAT=raw (#17)New Passed
    legacynominallosslessregressionAdded 2026-10-22, modified 2026-11-03

    Converts the synthetic 3-band BYTE image with FORMAT=raw, one of the 29 format names and aliases in the legacy test. Passes when the file holds exactly width x height x bands bytes and they are the input pixels in band-sequential (BSQ) order.

    Issue REVIEW-3: fixed: RAW output was padded to whole 256 x 256 tiles (and tile-ordered) unless OFORM was given

  18. FORMAT=RAW (#18)New Passed
    legacynominallosslessregressionAdded 2026-10-22, modified 2026-11-03

    Converts the synthetic 3-band BYTE image with FORMAT=RAW, one of the 29 format names and aliases in the legacy test. Passes when the file holds exactly width x height x bands bytes and they are the input pixels in band-sequential (BSQ) order.

    Issue REVIEW-3: fixed: RAW output was padded to whole 256 x 256 tiles (and tile-ordered) unless OFORM was given

  19. FORMAT=bmp (#19)New Passed
    legacylosslessregressionAdded 2026-10-22, modified 2026-11-03

    Converts the synthetic 3-band BYTE image with FORMAT=bmp, one of the 29 format names and aliases in the legacy test. Passes when the output decodes to exactly the input pixels.

    Issue REVIEW-4: fixed: the BMP writers threw ArrayIndexOutOfBoundsException for 3-band band-sequential or band-interleaved input

  20. FORMAT=BMP (#20)New Passed
    legacylosslessregressionAdded 2026-10-22, modified 2026-11-03

    Converts the synthetic 3-band BYTE image with FORMAT=BMP, one of the 29 format names and aliases in the legacy test. Passes when the output decodes to exactly the input pixels.

    Issue REVIEW-4: fixed: the BMP writers threw ArrayIndexOutOfBoundsException for 3-band band-sequential or band-interleaved input

  21. FORMAT=pnm (#21)New Passed
    legacynominallosslessregressionAdded 2026-10-22, modified 2026-11-03

    Converts the synthetic 3-band BYTE image with FORMAT=pnm, one of the 29 format names and aliases in the legacy test. Passes when the file is a binary PPM (P6, maxval 255) of the input's size whose samples are exactly the input pixels.

    Issue REVIEW-4: fixed: the jai_imageio PNM writer could not load on Java 17+; vicario now has its own PNM writer

  22. FORMAT=PNM (#22)New Passed
    legacynominallosslessregressionAdded 2026-10-22, modified 2026-11-03

    Converts the synthetic 3-band BYTE image with FORMAT=PNM, one of the 29 format names and aliases in the legacy test. Passes when the file is a binary PPM (P6, maxval 255) of the input's size whose samples are exactly the input pixels.

    Issue REVIEW-4: fixed: the jai_imageio PNM writer could not load on Java 17+; vicario now has its own PNM writer

  23. FORMAT=jfif (#23)New Passed
    legacynominalAdded 2026-10-22, modified 2026-11-03

    Converts the synthetic 3-band BYTE image with FORMAT=jfif, one of the 29 format names and aliases in the legacy test. Passes when the output has the input's size and bands and its mean is within 2 DN of the input (JPEG is lossy).

  24. FORMAT=JFIF (#24)New Passed
    legacynominalAdded 2026-10-22, modified 2026-11-03

    Converts the synthetic 3-band BYTE image with FORMAT=JFIF, one of the 29 format names and aliases in the legacy test. Passes when the output has the input's size and bands and its mean is within 2 DN of the input (JPEG is lossy).

  25. FORMAT=jpeg-ls (#25)New Known issue
    legacyoff-nominalAdded 2026-10-22, modified 2026-11-03

    Converts the synthetic 3-band BYTE image with FORMAT=jpeg-ls, one of the 29 format names and aliases in the legacy test. A known issue (IDS-10429): expected to fail until the format gets a writer. Passes when the output has the input's size and bands and its mean is within 2 DN of the input.

    Issue IDS-10429: no writer for FORMAT=jpeg-ls: jpeg-ls and jpeg-lossless were only served by jai_imageio's native CLib writer, which this build does not ship (and which wrote lossy JPEG under these names); whether to add true lossless JPEG / JPEG-LS output is undecided

  26. FORMAT=JPEG-LS (#26)New Known issue
    legacyoff-nominalAdded 2026-10-22, modified 2026-11-03

    Converts the synthetic 3-band BYTE image with FORMAT=JPEG-LS, one of the 29 format names and aliases in the legacy test. A known issue (IDS-10429): expected to fail until the format gets a writer. Passes when the output has the input's size and bands and its mean is within 2 DN of the input.

    Issue IDS-10429: no writer for FORMAT=JPEG-LS: jpeg-ls and jpeg-lossless were only served by jai_imageio's native CLib writer, which this build does not ship (and which wrote lossy JPEG under these names); whether to add true lossless JPEG / JPEG-LS output is undecided

  27. FORMAT=jpeg-lossless (#27)New Known issue
    legacyoff-nominalAdded 2026-10-22, modified 2026-11-03

    Converts the synthetic 3-band BYTE image with FORMAT=jpeg-lossless, one of the 29 format names and aliases in the legacy test. A known issue (IDS-10429): expected to fail until the format gets a writer. Passes when the output has the input's size and bands and its mean is within 2 DN of the input.

    Issue IDS-10429: no writer for FORMAT=jpeg-lossless: jpeg-ls and jpeg-lossless were only served by jai_imageio's native CLib writer, which this build does not ship (and which wrote lossy JPEG under these names); whether to add true lossless JPEG / JPEG-LS output is undecided

  28. FORMAT=JPEG-LOSSLESS (#28)New Known issue
    legacyoff-nominalAdded 2026-10-22, modified 2026-11-03

    Converts the synthetic 3-band BYTE image with FORMAT=JPEG-LOSSLESS, one of the 29 format names and aliases in the legacy test. A known issue (IDS-10429): expected to fail until the format gets a writer. Passes when the output has the input's size and bands and its mean is within 2 DN of the input.

    Issue IDS-10429: no writer for FORMAT=JPEG-LOSSLESS: jpeg-ls and jpeg-lossless were only served by jai_imageio's native CLib writer, which this build does not ship (and which wrote lossy JPEG under these names); whether to add true lossless JPEG / JPEG-LS output is undecided

  29. FORMAT=isis (#29)New Known issue
    legacyoff-nominalAdded 2026-10-22, modified 2026-11-03

    Converts the synthetic 3-band BYTE image with FORMAT=isis, one of the 29 format names and aliases in the legacy test. A known issue (IDS-10429): expected to fail until the format gets a writer. Passes when the output has the input's size and bands and its mean is within 2 DN of the input.

    Issue IDS-10429: no writer for FORMAT=isis: vicario has no ISIS writer, only an ISIS2 reader, so ISIS output is not a supported feature; the legacy loop ran this name but never checked the result, and adding ISIS output (ISIS2 or ISIS3) is undecided

  30. RAW output of gen_byte_bil.vic is exactly its samples, band sequentialNew Passed
    nominallosslessregressionAdded 2026-10-24

    Converts the synthetic 3-band BYTE band-interleaved-by-line (BIL) image with FORMAT=raw. Passes when the file holds exactly lines x samples x bands samples of 1 byte(s) each and they equal the input pixels in band-sequential (BSQ) order, big-endian.

    Issue REVIEW-3: fixed: RAW output was padded to whole 256 x 256 tiles (and tile-ordered) unless OFORM was given

  31. RAW output of gen_byte_bip.vic is exactly its samples, band sequentialNew Passed
    nominallosslessregressionAdded 2026-10-24

    Converts the synthetic 3-band BYTE band-interleaved-by-pixel (BIP) image with FORMAT=raw. Passes when the file holds exactly lines x samples x bands samples of 1 byte(s) each and they equal the input pixels in band-sequential (BSQ) order, big-endian.

    Issue REVIEW-3: fixed: RAW output was padded to whole 256 x 256 tiles (and tile-ordered) unless OFORM was given

  32. RAW output of gen_byte_gray.vic is exactly its samples, band sequentialNew Passed
    nominallosslessregressionAdded 2026-10-24

    Converts the synthetic 1-band BYTE image with FORMAT=raw. Passes when the file holds exactly lines x samples x bands samples of 1 byte(s) each and they equal the input pixels in band-sequential (BSQ) order, big-endian.

    Issue REVIEW-3: fixed: RAW output was padded to whole 256 x 256 tiles (and tile-ordered) unless OFORM was given

  33. RAW output of gen_half_bsq.vic is exactly its samples, band sequentialNew Passed
    nominallosslessregressionAdded 2026-10-24

    Converts the synthetic 3-band HALF (16-bit) image with FORMAT=raw. Passes when the file holds exactly lines x samples x bands samples of 2 byte(s) each and they equal the input pixels in band-sequential (BSQ) order, big-endian.

    Issue REVIEW-3: fixed: RAW output was padded to whole 256 x 256 tiles (and tile-ordered) unless OFORM was given

  34. RAW output of gen_real_100x100.vic is exactly its samples, band sequentialNew Passed
    off-nominallosslessregressionAdded 2026-10-24

    Converts the synthetic 100 x 100 REAL (float) image, which is not a multiple of the 256-pixel tile size, with FORMAT=raw. Passes when the file holds exactly lines x samples x bands samples of 4 byte(s) each and they equal the input pixels in band-sequential (BSQ) order, big-endian.

    Issue REVIEW-3: fixed: RAW output was padded to whole 256 x 256 tiles (and tile-ordered) unless OFORM was given

  35. RAW output of gen_byte_ns1_nl1024.vic is exactly its samples, band sequentialNew Passed
    off-nominallosslessregressionAdded 2026-10-24

    Converts the synthetic 1024-line by 1-sample BYTE image, four 256-line tiles tall, with FORMAT=raw. Passes when the file holds exactly lines x samples x bands samples of 1 byte(s) each and they equal the input pixels in band-sequential (BSQ) order, big-endian.

    Issue REVIEW-3: fixed: RAW output was padded to whole 256 x 256 tiles (and tile-ordered) unless OFORM was given

  36. BMP output of a band-interleaved-by-line (BIL) image keeps its pixelsNew Passed
    nominallosslessregressionAdded 2026-10-24

    Converts the synthetic 3-band BYTE BIL image (a line-interleaved raster the BMP writers could not handle) with FORMAT=bmp. Passes when the BMP decodes to exactly the input pixels.

    Issue REVIEW-4: fixed: the BMP writers threw ArrayIndexOutOfBoundsException for 3-band band-sequential or band-interleaved input

  37. HALF input to BMP without OFORM is refused with a non-zero exitNew Passed
    off-nominalAdded 2026-10-24

    Converts the synthetic 3-band HALF (16-bit) image with FORMAT=bmp; BMP cannot hold 16-bit samples. Passes when jConvertIIO exits non-zero and reports "Image write failed".

  38. a writer that crashes fails the conversion cleanlyNew Passed
    off-nominalregressionAdded 2026-10-24

    Converts the synthetic 3-band BYTE image with FORMAT=wbmp; the WBMP writer only takes 1-bit images and throws an IllegalArgumentException. Passes when jConvertIIO exits non-zero, names the failed writer and reports "Image write failed", with no stack trace.

    Issue REVIEW-4: fixed: a writer throwing a runtime exception or error escaped jConvertIIO as an uncaught stack trace

  39. PNM output of gen_byte_gray.vic keeps its pixelsNew Passed
    nominallosslessregressionAdded 2026-10-24

    Converts the synthetic 1-band BYTE image as an 8-bit PGM (P5, maxval 255) with FORMAT=pnm. Passes when the header gives that type, size and maxval and every sample equals the input pixel.

    Issue REVIEW-4: fixed: the jai_imageio PNM writer could not load on Java 17+; vicario now has its own PNM writer

  40. PNM output of gen_half_bsq.vic keeps its pixelsNew Passed
    nominallosslessregressionAdded 2026-10-24

    Converts the synthetic 3-band HALF (16-bit) image as a 16-bit PPM (P6, maxval 65535, big-endian) with FORMAT=pnm. Passes when the header gives that type, size and maxval and every sample equals the input pixel.

    Issue REVIEW-4: fixed: the jai_imageio PNM writer could not load on Java 17+; vicario now has its own PNM writer

  41. PNM output of gen_real_bsq.vic is refused with a messageNew Passed
    off-nominalAdded 2026-10-24

    Converts the synthetic REAL (float) image; PNM holds only 8- or 16-bit integers, with FORMAT=pnm. Passes when jConvertIIO exits non-zero, says why ("PNM holds 8- or 16-bit integer samples") and reports "Image write failed".

  42. PNM output of gen_byte_rgba.vic is refused with a messageNew Passed
    off-nominalAdded 2026-10-24

    Converts the synthetic 4-band BYTE image; PNM holds 1 or 3 bands, with FORMAT=pnm. Passes when jConvertIIO exits non-zero, says why ("PNM holds 1 (PGM) or 3 (PPM) bands") and reports "Image write failed".

  43. a PNM file written by jConvertIIO can be read back as inputNew Known issue
    off-nominalAdded 2026-10-24, modified 2026-11-03

    Writes the synthetic 3-band BYTE image as PNM, then converts that PNM to PNG. A known issue (IDS-10429): expected to fail until PNM input is supported. Passes when the second conversion succeeds and the PNG has exactly the original pixels.

    Issue IDS-10429: PNM input: jConvertIIO cannot read PNM input: jai_imageio 1.1's PNM reader cannot load on Java 17+ (it uses a JDK-internal class). PNM input is not documented, and a replacement reader is a new feature beyond the PNM output fix

  44. a TIFF file written by jConvertIIO can be read back as inputNew Passed
    nominallosslessregressionAdded 2026-10-24

    Writes the synthetic 3-band BYTE image as TIFF, then converts that TIFF to PNG. Passes when the second conversion succeeds with no exception and the PNG has exactly the original pixels.

    Issue NEW-output-1: fixed: reading TIFF input failed with IllegalStateException "seekForwardOnly and allowSearch can't both be true"

  45. HALF input to FORMAT=tif is losslessNew Passed
    nominallosslessAdded 2026-10-22, modified 2026-10-23

    Converts the synthetic HALF image with FORMAT=tif, which can hold 16-bit data. Passes when the output decodes to exactly the input pixels.

  46. HALF input to FORMAT=png is losslessNew Passed
    nominallosslessAdded 2026-10-22, modified 2026-10-23

    Converts the synthetic HALF image with FORMAT=png, which can hold 16-bit data. Passes when the output decodes to exactly the input pixels.

  47. HALF input to FORMAT=jpeg2000 is losslessNew Passed
    nominallosslessAdded 2026-10-22, modified 2026-10-23

    Converts the synthetic HALF image with FORMAT=jpeg2000, which can hold 16-bit data. Passes when the output decodes to exactly the input pixels.

  48. HALF input to FORMAT=pds is losslessNew Passed
    nominallosslessAdded 2026-10-22, modified 2026-10-23

    Converts the synthetic HALF image with FORMAT=pds, which can hold 16-bit data. Passes when the output decodes to exactly the input pixels.

  49. HALF input to FORMAT=vicar is losslessNew Passed
    nominallosslessAdded 2026-10-22, modified 2026-10-23

    Converts the synthetic HALF image with FORMAT=vicar, which can hold 16-bit data. Passes when the output decodes to exactly the input pixels.

  50. REAL input to FORMAT=tif is losslessNew Passed
    nominallosslessAdded 2026-10-22, modified 2026-10-23

    Converts the synthetic REAL image with FORMAT=tif, which can hold floating-point data. Passes when the output decodes to exactly the input pixels.

  51. REAL input to FORMAT=pds is losslessNew Passed
    nominallosslessAdded 2026-10-22, modified 2026-10-23

    Converts the synthetic REAL image with FORMAT=pds, which can hold floating-point data. Passes when the output decodes to exactly the input pixels.

  52. REAL input to FORMAT=vicar is losslessNew Passed
    nominallosslessAdded 2026-10-22, modified 2026-10-23

    Converts the synthetic REAL image with FORMAT=vicar, which can hold floating-point data. Passes when the output decodes to exactly the input pixels.

  53. a FORMAT with no registered writer is refused with a messageNew Passed
    off-nominalAdded 2026-10-24

    Converts the synthetic image with FORMAT=no-such-format, a name no ImageIO writer registers. Passes when jConvertIIO exits non-zero with a "no ImageWriter for FORMAT=" message, no stack trace and no output file.

  54. REAL input to PNG without OFORM is refused with a non-zero exitNew Passed
    off-nominalAdded 2026-10-22, modified 2026-10-23

    Converts a REAL (float) image to PNG without OFORM; PNG cannot hold floating-point data. Passes when jConvertIIO refuses with a non-zero exit code.

  55. HALF input to JPEG without OFORM is refused with a non-zero exitNew Passed
    off-nominalregressionAdded 2026-10-22, modified 2026-10-23

    Converts a HALF (16-bit) image to JPEG without OFORM; the JPEG writer cannot encode 16-bit data. Passes when jConvertIIO exits non-zero instead of leaving an empty file.

    Issue IDS-8497: fixed: jConvertIIO used to exit 0 and leave an empty file when the writer could not encode the data type

  56. preferOverRemovesTheJaiImageioWriterNew Passed
    unitUnit tests (JUnit): PNMImageWriterTestAdded 2026-10-24

    Imports the result of the JUnit test PNMImageWriterTest.preferOverRemovesTheJaiImageioWriter from the Maven build (target/surefire-reports). Passes when it passed in JUnit; a JUnit failure is shown with its message.

  57. writesEightBitGrayAsP5New Passed
    unitUnit tests (JUnit): PNMImageWriterTestAdded 2026-10-24

    Imports the result of the JUnit test PNMImageWriterTest.writesEightBitGrayAsP5 from the Maven build (target/surefire-reports). Passes when it passed in JUnit; a JUnit failure is shown with its message.

  58. writesSixteenBitRgbAsBigEndianP6New Passed
    unitUnit tests (JUnit): PNMImageWriterTestAdded 2026-10-24

    Imports the result of the JUnit test PNMImageWriterTest.writesSixteenBitRgbAsBigEndianP6 from the Maven build (target/surefire-reports). Passes when it passed in JUnit; a JUnit failure is shown with its message.

  59. refusesFourBandsNew Passed
    unitUnit tests (JUnit): PNMImageWriterTestAdded 2026-10-24

    Imports the result of the JUnit test PNMImageWriterTest.refusesFourBands from the Maven build (target/surefire-reports). Passes when it passed in JUnit; a JUnit failure is shown with its message.

  60. class is listed under a feature in features.ymlNew Passed
    suiteUnit tests (JUnit): PNMImageWriterTestAdded 2026-10-24

    Bookkeeping, not a product test: checks that the JUnit class jpl.mipl.io.plugins.PNMImageWriterTest is listed in a feature's junit: list in features.yml, so its results are grouped under that feature.

Data type conversion

Changing the output data type (OFORM) with or without rescaling, clamping, and float data to 8-bit display formats.

14 tests · nominal13 off-nominal1 lossless4 mission-data1 regression7 legacy1

  1. REAL to PNG with OFORM=BYTE is stretched, not blankNew Passed
    nominallegacyregressionAdded 2026-10-22, modified 2026-10-23

    Converts the legacy REAL 100 x 100 image to PNG with OFORM=BYTE. Passes when the PNG is BYTE, stretched to the byte range (maximum at least 250) and not blank (standard deviation over 10).

    Issue IDS-7610: float VICAR to PNG came out blank

  2. REAL to BYTE with RESCALE=false keeps the values (0..74)New Passed
    nominalAdded 2026-10-22, modified 2026-10-23

    Converts the REAL image (values 0 to 74) to BYTE with RESCALE=false. Passes when the output values are exactly 0 to 74.

  3. HALF to BYTE with the default RESCALE fills the byte rangeNew Passed
    nominalAdded 2026-10-22, modified 2026-10-23

    Converts the synthetic HALF image to BYTE with the default rescaling. Passes when the output is BYTE and fills the byte range (maximum at least 250).

  4. BYTE to HALF with RESCALE=false is exactNew Passed
    nominallosslessAdded 2026-10-22, modified 2026-10-23

    Converts the synthetic BYTE image to HALF with RESCALE=false. Passes when the output is 16-bit with pixels equal to the input.

  5. BYTE to REAL with RESCALE=false keeps the valuesNew Passed
    nominalAdded 2026-10-22, modified 2026-10-23

    Converts the synthetic BYTE image to REAL with RESCALE=false. Passes when the output is floating point with the input's minimum, maximum and mean.

  6. BYTE to HALF with the default RESCALE keeps the valuesNew Passed
    nominalregressionlosslessAdded 2026-10-24, modified 2026-10-28

    Converts the synthetic BYTE image (values 0 to 217) to HALF with the default rescaling. A widening conversion is not stretched unless asked for. Passes when the output is 16-bit with pixels equal to the input.

    Issue REVIEW-6: fixed: the default rescale ran in the source type, so BYTE to HALF saturated to 3 distinct values

  7. BYTE to REAL with the default RESCALE keeps the valuesNew Passed
    nominalregressionAdded 2026-10-24

    Converts the synthetic BYTE image to REAL with the default rescaling. Passes when the output is floating point with the input's minimum, maximum and mean (no stretch to the float range, no saturation).

    Issue REVIEW-6: fixed: BYTE to REAL with the default rescale saturated to 2 distinct values

  8. HALF to HALF with the default RESCALE keeps the valuesNew Passed
    nominalregressionlosslessAdded 2026-10-24, modified 2026-10-28

    Converts the synthetic HALF image (values 0 to 217) with OFORM=HALF, its own data type. RESCALE applies only when OFORM changes to a narrower type. Passes when the output pixels equal the input.

    Issue REVIEW-6: fixed: the same data type was stretched to the full 16-bit range

  9. BYTE to HALF with RESCALE_CONSTANT and RESCALE_OFFSET is not clipped to the byte rangeNew Passed
    nominalregressionAdded 2026-10-22, modified 2026-10-28

    Converts the synthetic BYTE image (0 to 217) to HALF with RESCALE_CONSTANT=10 RESCALE_OFFSET=3. The rescale must run in the 16-bit output type. Passes when the output spans exactly 3 to 2173 (217 x 10 + 3, past the byte range) with mean equal to the input mean x 10 + 3.

    Issue REVIEW-6: fixed: an explicit rescale on a widening OFORM was clipped to the source (byte) range

  10. HALF to BYTE with VALID_MINIMUM and VALID_MAXIMUM stretches that range to 0..255New Passed
    off-nominalAdded 2026-10-24, modified 2026-10-28

    Converts the synthetic HALF image (0 to 217) to BYTE with VALID_MINIMUM=0 VALID_MAXIMUM=108. Passes when the output is BYTE, spans exactly 0 to 255, and values above 108 are clipped to 255.

  11. HALF to BYTE with the default RESCALE reaches 255New Passed
    nominalregressionAdded 2026-10-24, modified 2026-10-28

    Converts the synthetic HALF image (0 to 217) to BYTE with the default rescaling. Passes when the output spans exactly 0 to 255 (the full unsigned byte range, not 0 to 254).

    Issue NEW-cli-1: fixed: the BYTE rescale ceiling was Byte.MAX_VALUE * 2 = 254, not 255

  12. BYTE to BYTE with OFORM=BYTE keeps the valuesNew Passed
    nominalregressionlosslessAdded 2026-10-22, modified 2026-10-28

    Converts the synthetic gray BYTE image (values 0 to 157) with OFORM=BYTE, its own data type. Passes when the output pixels equal the input (no stretch).

    Issue NEW-cli-1: fixed: OFORM=BYTE on BYTE input stretched the data to 0..254

  13. CLAMP=(10,100) limits the output rangeNew Passed
    nominalAdded 2026-10-22, modified 2026-10-23

    Converts the synthetic HALF image with CLAMP=(10,100). Passes when the output values span exactly 10 to 100.

  14. 12-bit MER EDR to an 8-bit PNG browse imageNew Passed
    mission-datanominalData type conversion (mission products)Added 2026-10-22, modified 2026-10-23

    Converts a public 12-bit MER Navcam EDR to an 8-bit PNG browse image with OFORM=BYTE. Passes when the PNG is a 512 x 512 BYTE image that is not blank.

Regions, subsampling and bands

Cropping (SOURCE_REGION, CROP), subsampling, scaling, band selection and reordering (READ_BANDS, BANDS), single band to RGB (2RGB), and PNG alpha (WRITE_TRANSPARENCY).

13 tests · nominal11 off-nominal2 lossless2 regression6

  1. SOURCE_REGION=(x,y,width,height) cuts out exactly that regionNew Passed
    nominalAdded 2026-10-23

    Cuts out SOURCE_REGION=(10,20,16,8) from the synthetic image. Passes when the output is 16 x 8 x 3 and its pixel hash equals the hash computed from the generator formula for exactly that region. The region is outlined on the source preview.

  2. SOURCE_REGION running past the image edge is clipped, not an errorNew Passed
    off-nominalregressionAdded 2026-10-23

    Asks for a 20 x 20 region at (40,60) of the 48 x 64 image, which runs past both edges. Passes when the output is clipped to 8 x 4 with exactly those pixels, rather than an error.

    Issue IDS-7560: EOF exception when the region is not fully inside the image

  3. SUBSAMPLING=(2,2,0,0) keeps every Nth sample and lineNew Passed
    nominalregressionAdded 2026-10-23

    Subsamples with SUBSAMPLING=(2,2,0,0) (x step, y step, x offset, y offset). Passes when the output size and pixel hash match the samples and lines the formula selects. The kept pixels are marked on the source preview.

    Issue IDS-7098: subsampling factor did not work

  4. SUBSAMPLING=(3,2,1,1) keeps every Nth sample and lineNew Passed
    nominalregressionAdded 2026-10-23

    Subsamples with SUBSAMPLING=(3,2,1,1) (x step, y step, x offset, y offset). Passes when the output size and pixel hash match the samples and lines the formula selects. The kept pixels are marked on the source preview.

    Issue IDS-7098: subsampling factor did not work

  5. CROP=(x,y,width,height) to png cuts out exactly that areaNew Passed
    nominalregressionAdded 2026-10-24

    Crops the 48 x 64 gray image with CROP=(1,5,11,7) (x, y, width, height) and writes png. Passes when the output is 11 wide by 7 high and its pixel hash equals the hash computed from the generator formula for columns 1 to 11 and rows 5 to 11.

    Issue REVIEW-11: fixed: CROP used x as the y offset, and CROP to VICAR failed with a raster bounds error

  6. CROP=(x,y,width,height) to vicar cuts out exactly that areaNew Passed
    nominalregressionAdded 2026-10-24

    Crops the 48 x 64 gray image with CROP=(1,5,11,7) (x, y, width, height) and writes vicar. Passes when the output is 11 wide by 7 high and its pixel hash equals the hash computed from the generator formula for columns 1 to 11 and rows 5 to 11.

    Issue REVIEW-11: fixed: CROP used x as the y offset, and CROP to VICAR failed with a raster bounds error

  7. CROP=(x,y) crops from (x,y) to the image edgeNew Passed
    nominalregressionAdded 2026-10-23, modified 2026-10-24

    Crops the 48 x 64 gray image with the two-value form CROP=(40,60) and writes VICAR. Passes when the output is the 8 x 4 corner from (40,60) to the image edge, with exactly those pixels.

    Issue REVIEW-11: fixed: the two-value CROP form always failed with "rectangular crop area must not be empty"

  8. CROP outside the image is refused with a clear errorNew Passed
    off-nominalAdded 2026-10-23, modified 2026-10-24

    Crops the 48 x 64 gray image with CROP=(100,100,5,5), which lies outside the image. Passes when jConvertIIO exits non-zero with a message naming CROP and no Java stack trace.

  9. SCALE=(2,2,0,0) doubles the image sizeNew Passed
    nominalAdded 2026-10-23

    Scales the synthetic image with SCALE=(2,2,0,0). Passes when the output is 96 x 128 x 3 with the source's value range.

  10. READ_BANDS selects bands on readNew Passed
    nominalAdded 2026-10-23

    Reads only some bands, with READ_BANDS=2 and with READ_BANDS=0,2. Passes when each output has exactly those bands, with the pixel hash computed for them.

  11. BANDS reorders bands (2,1,0 twice restores the original)New Passed
    nominallosslessAdded 2026-10-23

    Reverses the bands with BANDS=2,1,0, then reverses the result again. Passes when the first output has the bands reversed and the second equals the original.

  12. 2RGB=true turns a single band into gray RGBNew Passed
    nominalAdded 2026-10-23

    Writes a single-band image to PNG with 2RGB=true and with 2RGB=false. Passes when the first PNG is RGB with the gray value in all three bands and the second is a gray PNG.

  13. WRITE_TRANSPARENCY writes the fourth band as PNG alphaNew Passed
    nominallosslessAdded 2026-10-23

    Writes a 4-band image to PNG with WRITE_TRANSPARENCY=true. Passes when the PNG is RGBA and the fourth band is the alpha channel, pixel for pixel.

XML metadata and parser security

Label DOM utilities and XML debug output (XML=true), with every XML parser hardened against external entity (XXE) attacks.

18 tests · nominal1 malformed-input4 regression3 security4 suite1 unit12

  1. XML=true writes the label DOM as XML debug documentsNew Passed
    nominalAdded 2026-10-22, modified 2026-10-23

    Converts the synthetic image to PDS3 with XML=true, which writes the label DOM as XML debug files. Passes when at least one XML file is written and each is well formed (opens and closes its root element).

  2. a DOCTYPE with a missing external DTD parses; the DTD is never loadedNew Passed
    securitymalformed-inputregressionAdded 2026-10-22, modified 2026-10-23

    Parses, with the TreeInfo tool, an XML document whose DOCTYPE points at a DTD that does not exist. Passes when there is no exception: the hardened parser never loads external DTDs.

    Issue IDS-10406: before the fix this failed with FileNotFoundException for the DTD

  3. external entities are not resolved (no file read, no error)New Passed
    securitymalformed-inputAdded 2026-10-22, modified 2026-10-23

    Parses a hostile XML document with external general and parameter entities: one reads a local "secret" file, another points at a missing file. Passes when the secret text never appears in the output and nothing tries to open the missing file.

    Issue IDS-10406: XXE: external general and parameter entities must be ignored

  4. an XSL stylesheet cannot read files through external entitiesNew Passed
    securitymalformed-inputregressionAdded 2026-10-27

    Converts the synthetic image to PDS3 with XSL= set to a copy of VicarToPDSmer1.xsl that declares an external entity reading a local "secret" file and writes it into a LEAK label item. Passes when the conversion still produces a valid label and the secret text appears in neither the label nor the log.

    Issue IDS-10406: fixed: stylesheets were parsed without XXE protection (Sonar java:S2755 on TransformerFactory), so XSL= could read any local file into the output label

  5. an XSL stylesheet cannot read files with document(), write files or call JavaNew Passed
    securitymalformed-inputregressionAdded 2026-11-11

    Converts the synthetic image to PDS3 with XSL= set to a copy of VicarToPDSmer1.xsl that adds a LEAK label item filled by document() from a local "secret" XML file, a JAVA item filled by a Xalan Java extension call that builds a marker string, and a Xalan redirect:write that tries to create a file. Passes when the conversion still writes a valid label, the secret and the marker appear in neither the label nor the log, and no file is created.

    Issue IDS-10406: fixed: Xalan ignores the JAXP 1.5 attributes (Sonar java:S2755 on newTransformerFactory), so XSL= could read local XML files with document(), write files with redirect:write and run Java through extension functions

  6. externalParameterEntityIsNotResolvedNew Passed
    unitUnit tests (JUnit): DOMutilsXXETestAdded 2026-10-21

    Imports the result of the JUnit test DOMutilsXXETest.externalParameterEntityIsNotResolved from the Maven build (target/surefire-reports). Passes when it passed in JUnit; a JUnit failure is shown with its message.

  7. externalDtdIsNotLoadedNew Passed
    unitUnit tests (JUnit): DOMutilsXXETestAdded 2026-10-21

    Imports the result of the JUnit test DOMutilsXXETest.externalDtdIsNotLoaded from the Maven build (target/surefire-reports). Passes when it passed in JUnit; a JUnit failure is shown with its message.

  8. factoryHasXXEFeaturesDisabledNew Passed
    unitUnit tests (JUnit): DOMutilsXXETestAdded 2026-10-21

    Imports the result of the JUnit test DOMutilsXXETest.factoryHasXXEFeaturesDisabled from the Maven build (target/surefire-reports). Passes when it passed in JUnit; a JUnit failure is shown with its message.

  9. stylesheetDocumentFunctionCannotReadFilesNew Passed
    unitUnit tests (JUnit): DOMutilsXXETestAdded 2026-11-11

    Imports the result of the JUnit test DOMutilsXXETest.stylesheetDocumentFunctionCannotReadFiles from the Maven build (target/surefire-reports). Passes when it passed in JUnit; a JUnit failure is shown with its message.

  10. stylesheetIncludeCannotReadFilesNew Passed
    unitUnit tests (JUnit): DOMutilsXXETestAdded 2026-11-11

    Imports the result of the JUnit test DOMutilsXXETest.stylesheetIncludeCannotReadFiles from the Maven build (target/surefire-reports). Passes when it passed in JUnit; a JUnit failure is shown with its message.

  11. stylesheetStillTransformsNew Passed
    unitUnit tests (JUnit): DOMutilsXXETestAdded 2026-10-27

    Imports the result of the JUnit test DOMutilsXXETest.stylesheetStillTransforms from the Maven build (target/surefire-reports). Passes when it passed in JUnit; a JUnit failure is shown with its message.

  12. literalResultElementsKeepTheirAttributesNew Passed
    unitUnit tests (JUnit): DOMutilsXXETestAdded 2026-11-11

    Imports the result of the JUnit test DOMutilsXXETest.literalResultElementsKeepTheirAttributes from the Maven build (target/surefire-reports). Passes when it passed in JUnit; a JUnit failure is shown with its message.

  13. namespacedLabelStillParsesNew Passed
    unitUnit tests (JUnit): DOMutilsXXETestAdded 2026-10-21

    Imports the result of the JUnit test DOMutilsXXETest.namespacedLabelStillParses from the Maven build (target/surefire-reports). Passes when it passed in JUnit; a JUnit failure is shown with its message.

  14. stylesheetCannotUseRedirectToWriteFilesNew Passed
    unitUnit tests (JUnit): DOMutilsXXETestAdded 2026-11-11

    Imports the result of the JUnit test DOMutilsXXETest.stylesheetCannotUseRedirectToWriteFiles from the Maven build (target/surefire-reports). Passes when it passed in JUnit; a JUnit failure is shown with its message.

  15. stylesheetExternalEntityIsNotResolvedNew Passed
    unitUnit tests (JUnit): DOMutilsXXETestAdded 2026-10-27

    Imports the result of the JUnit test DOMutilsXXETest.stylesheetExternalEntityIsNotResolved from the Maven build (target/surefire-reports). Passes when it passed in JUnit; a JUnit failure is shown with its message.

  16. stylesheetCannotCallJavaExtensionsNew Passed
    unitUnit tests (JUnit): DOMutilsXXETestAdded 2026-11-11

    Imports the result of the JUnit test DOMutilsXXETest.stylesheetCannotCallJavaExtensions from the Maven build (target/surefire-reports). Passes when it passed in JUnit; a JUnit failure is shown with its message.

  17. externalGeneralEntityIsNotResolvedNew Passed
    unitUnit tests (JUnit): DOMutilsXXETestAdded 2026-10-21

    Imports the result of the JUnit test DOMutilsXXETest.externalGeneralEntityIsNotResolved from the Maven build (target/surefire-reports). Passes when it passed in JUnit; a JUnit failure is shown with its message.

  18. class is listed under a feature in features.ymlNew Passed
    suiteUnit tests (JUnit): DOMutilsXXETestAdded 2026-10-21, modified 2026-11-11

    Bookkeeping, not a product test: checks that the JUnit class jpl.mipl.io.util.DOMutilsXXETest is listed in a feature's junit: list in features.yml, so its results are grouped under that feature.

Batch, streaming and remote input

Batch runs from an argument file (serial and parallel), files without extensions, output to stdout, and https input from the public PDS archive.

9 tests · nominal4 off-nominal4 lossless6 mission-data1 regression6

  1. ARGFILE batch runs every lineNew Passed
    nominallosslessAdded 2026-10-23

    Runs a batch file of 3 conversions (PNG, TIFF and VICAR from different inputs) with ARGFILE. Passes when the run exits 0 and every output exists with its input's pixels.

  2. ARGFILE batch with PARALLEL_BATCH=2 runs every lineNew Passed
    nominallosslessAdded 2026-10-23

    Runs a batch file of 3 conversions (PNG, TIFF and VICAR from different inputs) with ARGFILE and PARALLEL_BATCH=2. Passes when the run exits 0 and every output exists with its input's pixels.

  3. input and output file names without extensionsNew Passed
    off-nominalregressionlosslessAdded 2026-10-23

    Converts an input file that has no extension to an output name with no extension. Passes when the output has the input pixels.

    Issue IDS-10067: launchers failed on file names with no extension

  4. OUT=- with SILENT writes the image to stdoutNew Passed
    nominalregressionlosslessAdded 2026-10-23, modified 2026-10-24

    Converts the synthetic image to PNG with OUT=- and SILENT, capturing stdout as raw bytes. Passes when the exit code is 0, stdout starts with the PNG signature, decodes to the input pixels and is byte-identical to the same conversion written to a file, and no file named - is created.

    Issue REVIEW-12: fixed: OUT=- failed with "image == null!", wrote an empty file named "-" and nothing to stdout

  5. OUT=- without SILENT keeps messages off stdoutNew Passed
    nominalregressionlosslessAdded 2026-10-23, modified 2026-10-24

    Converts the synthetic image to VICAR with OUT=- and no SILENT. Passes when the exit code is 0, the progress messages appear on stderr, and stdout holds only the VICAR file (it starts with LBLSIZE= and decodes to the input pixels).

    Issue REVIEW-12: fixed: with OUT=- the messages would have been mixed into the image on stdout

  6. FORMAT without OUT, and OUT=- without FORMAT, are refusedNew Passed
    off-nominalregressionAdded 2026-10-23, modified 2026-10-24

    Runs jConvertIIO with FORMAT=png but no OUT, then with OUT=- but no FORMAT. Passes when both exit non-zero with a message naming the missing keyword, write nothing to stdout or to a file named -, and show no Java stack trace.

    Issue REVIEW-12: fixed: FORMAT without OUT failed with "image == null!" and left an empty file named "-"

  7. OUT=- on an ARGFILE line is refusedNew Passed
    off-nominalregressionAdded 2026-10-28

    Runs an ARGFILE batch whose second line converts to PNG with OUT=-. Passes when the run exits non-zero with an error naming OUT=- and ARGFILE on stderr, and no PNG data reaches stdout (it would be mixed with the batch progress text).

    Issue REVIEW-12: fixed: in an ARGFILE batch, OUT=- wrote the image to stdout mixed with the batch progress text

  8. OUT=- on an ARGFILE line is refused (PARALLEL_BATCH=2)New Passed
    off-nominalregressionAdded 2026-10-28

    Runs an ARGFILE batch with PARALLEL_BATCH=2 whose second line converts to PNG with OUT=-. Passes when the run exits non-zero with an error naming OUT=- and ARGFILE on stderr, and no PNG data reaches stdout (it would be mixed with the batch progress text).

    Issue REVIEW-12: fixed: in an ARGFILE batch, OUT=- wrote the image to stdout mixed with the batch progress text

  9. https input from the public PDS archive matches the local copyNew Passed
    mission-datalosslessBatch, streaming and remote input (network)Added 2026-10-23

    Converts an MSL Navcam thumbnail straight from its https URL on the public PDS Imaging Node. Passes when the result has the same pixels as the local copy.

Visual check (replaces JADE review)

Every output a person would look at decodes to an image of the right size that is neither blank nor saturated, with a preview in the report. Replaces opening each output in the JADE viewer in the legacy procedure; the viewer itself is not tested.

8 tests · nominal1 mission-data7 legacy8

  1. legacy step 18: PNG converted to JPEG displaysNew Passed
    legacynominalAdded 2026-10-23

    Legacy step 18, once checked by eye in JADE: converts the synthetic image to PNG, then the PNG to JPEG. Passes when the JPEG displays: BYTE, the same size as the PNG, not blank (standard deviation over 3), not black (mean over 2) and not saturated (mean under 253). The preview is attached for a person to look at.

  2. browse image of msl-navcam-thumb-img displaysNew Passed
    mission-datalegacyAdded 2026-10-23

    Makes an 8-bit PNG browse image (OFORM=BYTE) of msl-navcam-thumb-img, as a reviewer once viewed it in JADE. Passes when it displays: the source's size, BYTE, and not blank, black or saturated. The preview is attached.

  3. browse image of m2020-navcam-thumb-img displaysNew Passed
    mission-datalegacyAdded 2026-10-23

    Makes an 8-bit PNG browse image (OFORM=BYTE) of m2020-navcam-thumb-img, as a reviewer once viewed it in JADE. Passes when it displays: the source's size, BYTE, and not blank, black or saturated. The preview is attached.

  4. browse image of cassini-iss-img displaysNew Passed
    mission-datalegacyAdded 2026-10-23

    Makes an 8-bit PNG browse image (OFORM=BYTE) of cassini-iss-img, as a reviewer once viewed it in JADE. Passes when it displays: the source's size, BYTE, and not blank, black or saturated. The preview is attached.

  5. browse image of astropy-horsehead-fits displaysNew Passed
    mission-datalegacyAdded 2026-10-23

    Makes an 8-bit PNG browse image (OFORM=BYTE) of astropy-horsehead-fits, as a reviewer once viewed it in JADE. Passes when it displays: the source's size, BYTE, and not blank, black or saturated. The preview is attached.

  6. browse image of mer1-navcam-edr displaysNew Passed
    mission-datalegacyVisual check (full-size products)Added 2026-10-23

    Makes an 8-bit PNG browse image (OFORM=BYTE) of mer1-navcam-edr, as a reviewer once viewed it in JADE. Passes when it displays: the source's size, BYTE, and not blank, black or saturated. The preview is attached.

  7. browse image of msl-navcam-edr-img displaysNew Passed
    mission-datalegacyVisual check (full-size products)Added 2026-10-23

    Makes an 8-bit PNG browse image (OFORM=BYTE) of msl-navcam-edr-img, as a reviewer once viewed it in JADE. Passes when it displays: the source's size, BYTE, and not blank, black or saturated. The preview is attached.

  8. browse image of m2020-navcam-edr-img displaysNew Passed
    mission-datalegacyVisual check (full-size products)Added 2026-10-23

    Makes an 8-bit PNG browse image (OFORM=BYTE) of m2020-navcam-edr-img, as a reviewer once viewed it in JADE. Passes when it displays: the source's size, BYTE, and not blank, black or saturated. The preview is attached.

Python label scripts

The Python utilities in src/main/scripts: xml_swap.py (replace, list and show modes, XXE hardening) and build_mesh_extras.py (mesh label extras, path validation).

5 tests · nominal3 off-nominal1 malformed-input1 regression2 security2

  1. replace mode swaps one element and keeps the restNew Passed
    nominalAdded 2026-10-22, modified 2026-10-23

    Runs xml_swap.py in replace mode: replaces //pds:A in a target document with the element from a source document. Passes when the output has the new element, keeps the untouched sibling and no longer has the old value.

  2. list mode prints structural XPathsNew Passed
    nominalAdded 2026-10-22, modified 2026-10-23

    Runs xml_swap.py --list-xpaths on a PDS4-namespaced document. Passes when it exits 0 and lists the pds:A element path.

  3. show mode does not expand external entitiesNew Passed
    securitymalformed-inputregressionAdded 2026-10-22, modified 2026-10-23

    Runs xml_swap.py --show-xpath on a document with an external entity that would read a local "secret" file. Passes when the element is printed with the entity unexpanded (&xxe;) and the secret never appears.

    Issue IDS-10407: lxml parser must not resolve entities or use the network

  4. build_mesh_extras.py writes the mesh extras JSON (LabelObj usage)New Passed
    nominalAdded 2026-10-23

    Runs build_mesh_extras.py on a mesh .mtl file. Passes when the JSON it writes holds the solar longitude and the texture PNG list from the .mtl.

  5. build_mesh_extras.py refuses paths outside its folders or of the wrong typeNew Passed
    securityoff-nominalregressionAdded 2026-10-23

    Runs build_mesh_extras.py with four bad paths: an output outside its folders (../escaped.json), an output that is not .json, and /etc/hosts as the .mtl and as the base JSON. Passes when each run exits non-zero with a build_mesh_extras: error and writes nothing.

    Issue S8707: SonarCloud pythonsecurity:S8707 path traversal via command-line arguments

PDS4 label generation (Labelocity)

Generating detached PDS4 labels from Velocity templates with the public Labelocity release (PDS4 writer and mission templates) and the vicario build under test. Generated labels must match the archive label's array structure and read back to the same pixels.

2 tests · nominal2 mission-data2

  1. Mars 2020 Navcam: generated label matches the archive label and reads backNew Passed
    mission-datanominalAdded 2026-10-23

    Generates a PDS4 label for a public Mars 2020 Navcam image with Labelocity (Velocity templates plus vicario). Passes when the label is complete XML with no unresolved template references, names the image file, has a urn:nasa:pds logical identifier, describes the image array exactly as the official archive label does, and reads back to the same pixels.

  2. MSL Navcam: generated label describes and reads back the imageNew Passed
    mission-datanominalAdded 2026-10-23

    Generates a PDS4 label for a public MSL Navcam image (MSL has no official PDS4 label to compare with). Passes when the label is valid as above, describes a 64 x 64 array and reads back to the image's pixels.

Test suite integrity

Feature registry, specs and test-data manifest are consistent.

18 tests · nominal6 off-nominal5 suite18

  1. feature ids are unique and well formed, with a name and descriptionNew Passed
    suiteFeature registryAdded 2026-10-22, modified 2026-10-23

    Checks features.yml: feature ids are unique, lowercase and not reserved, and every feature has a name, a description and a valid status.

  2. every active feature has specs that carry its tagNew Passed
    suiteFeature registryAdded 2026-10-22, modified 2026-10-23

    Checks that every active feature lists spec files that exist and call feature() with its id, so their tests carry the feature's tag.

  3. planned features name a milestone and excluded features give a reasonNew Passed
    suiteFeature registryAdded 2026-10-22, modified 2026-10-23

    Checks that planned features name a milestone and excluded features give a reason.

  4. every spec belongs to a featureNew Passed
    suiteFeature registryAdded 2026-10-22, modified 2026-10-23

    Checks that every spec file in features/ is listed under a feature in features.yml.

  5. every manifest asset is pinned, licensed and used by a spec or helperNew Passed
    suiteFeature registryAdded 2026-10-22, modified 2026-10-23

    Checks the test data manifest: every downloaded file is pinned by SHA-256, has a license and is used by a spec or helper.

  6. every test has a description and a scope tagNew Passed
    suiteFeature registryAdded 2026-10-23, modified 2026-10-28

    Lists the whole suite (playwright test --list) and checks that every test has a "what it checks" description and at least one scope tag (@nominal, @off-nominal, @malformed-input, @lossless, @mission-data, @regression, @security, @legacy, @suite, @unit), so the procedures report describes every test.

  7. every test has valid added and modified datesNew Passed
    suiteFeature registryAdded 2026-10-28

    Lists the whole suite and checks that every test has an added date (about(..., { added, modified })), that the dates are YYYY-MM-DD and not in the future, and that modified is after added. Imported JUnit results are exempt: their dates come from git. The report counts new and modified tests per release from these dates.

  8. the report overview lists each feature's tests, linked to their proceduresNew Passed
    suitenominalTest report and site pagesAdded 2026-10-28

    Runs a nested Playwright run of three sample tests (one passes, one fails, one is skipped) through the report's overview reporter. Passes when the feature's drop-down table on the overview lists all three with the right result, every link in it points at an existing test entry on the procedures page, the drop-down ends with a "Detailed procedures" link to the feature's section there, and the overview shows no image previews.

  9. the overview summary counts each feature's tests, and those new or modified since the last releaseNew Passed
    suitenominalTest report and site pagesAdded 2026-10-28

    Runs the three sample tests with the baseline release set to v9.9.9 (2026-02-01): one was added before it and modified after, one added after it, one untouched since. Passes when the overview's summary row for the feature counts 3 tests, 1 passed, 1 failed, 1 skipped, 1 new and 1 modified, the total row agrees with summary.json, the note names the baseline release, and the drop-down marks each test New, Modified or nothing.

  10. the procedures page shows each test's history and image previewsNew Passed
    suitenominalTest report and site pagesAdded 2026-10-28

    Runs the three sample tests; the passing one attaches an image preview. Passes when that test's entry on the procedures page shows its added and modified dates and the preview, copied into the report's images folder, and no other sample test shows an image.

  11. a known failure is reported as a known issue, not a failureNew Passed
    suitenominalTest report and site pagesAdded 2026-11-03

    Runs a nested Playwright run of a sample test marked as a known failure (IDS-0001, Playwright's expected failure) that fails. Passes when the overview's summary row counts it under Known issues and not Failed, its drop-down row reads "Known issue" and links to its procedure, and the Known issues section lists it under IDS-0001.

  12. known failures sharing a ticket each show their own reasonNew Passed
    suiteoff-nominalTest report and site pagesAdded 2026-11-03

    Runs two sample known failures under one ticket (IDS-0003) with different reasons ("limitation A", "limitation B"). Passes when the Known issues section has one IDS-0003 entry counting 2 tests, its heading names neither reason, and each test is listed with its own reason.

  13. a known failure that passes is reported as passed unexpectedlyNew Passed
    suiteoff-nominalTest report and site pagesAdded 2026-11-03

    Runs a nested Playwright run of a sample test marked as a known failure (IDS-0002) that passes, as when the bug gets fixed or the behaviour changes. Passes when the overview counts it as Failed, its drop-down row reads "Passed unexpectedly", the Failures section and the job summary (overview.md) say it was expected to fail under IDS-0002 but passed and to remove knownFailure(), and the run's result is Failed.

  14. the report prints to one PDFNew Passed
    suitenominalTest report and site pagesAdded 2026-11-03

    Runs the three sample tests, then scripts/report-pdf.mjs on their report (it opens the overview and procedures pages in Chromium, opens every drop-down and prints them as one PDF). Passes when the script exits 0 and writes a PDF file (it starts with %PDF-) of more than 10 kB whose links are all either web addresses or jumps inside the PDF: none points at a local file (the overview, the procedures page or the Playwright report, which a downloaded PDF does not have).

  15. the PDF script refuses a folder without a reportNew Passed
    suiteoff-nominalTest report and site pagesAdded 2026-11-03

    Runs scripts/report-pdf.mjs on an empty folder (no test run yet). Passes when it exits non-zero, says the folder has no index.html, and writes no PDF.

  16. the site lists each capability's tests, linked to their proceduresNew Passed
    suitenominalTest report and site pagesAdded 2026-10-28

    Builds the GitHub Pages site from a sample report: a nested Playwright run of three sample tests (one passes, one fails, one is skipped). Passes when the capability's drop-down table lists the three sample tests with the right result, and every link in it points at an existing test entry on the published procedures page.

  17. the site labels known issues and unexpected passesNew Passed
    suiteoff-nominalTest report and site pagesAdded 2026-11-03

    Builds the GitHub Pages site from a nested run of two sample known failures: one fails (a known issue) and one passes. Passes when the capability's drop-down lists the first as "Known issue" and the second as "Passed unexpectedly" in failure styling, both linked to existing entries on the published procedures page.

  18. the site builds without test resultsNew Passed
    suiteoff-nominalTest report and site pagesAdded 2026-10-28

    Builds the GitHub Pages site from an empty report folder (no test run yet). Passes when the build succeeds, the page says there are no test results yet, and no capability has a drop-down test table.