VICARIO test procedures
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.
Scope of testing
- 121 expected use with valid input.
- 42 unsupported options, edge cases or invalid arguments; the tool must handle them or fail cleanly.
- 11 truncated, corrupt or hostile files.
- 89 the output must decode to exactly the same pixels (pixel hash) as the input.
- 37 uses public products from the PDS archive.
- 82 guards a bug that was fixed (see its issue).
- 6 XML external entities and path traversal.
- 45 a case from the old tstjConvertIIO.csh / ST2-4.1 procedure.
- 27 checks the test suite itself (registry, data manifest).
- 44 a JUnit result imported from the Maven build.
Features
- VICAR image read/write 53
- VICAR binary headers and prefixes 18
- PDS3 products 23
- PDS label transcoding (XSL) 5
- PDS4 images 4
- PDS4 tables 17
- ISIS cubes 7
- FITS images 1
- Magellan products 2
- Output formats 60
- Data type conversion 14
- Regions, subsampling and bands 13
- XML metadata and parser security 18
- Batch, streaming and remote input 9
- Visual check (replaces JADE review) 8
- Python label scripts 5
- PDS4 label generation (Labelocity) 2
- Test suite integrity 18
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
-
byte: BSQ, BIL and BIP decode to the same pixelsNew PassednominalAdded 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).
-
byte/bsq: VICAR to VICAR round trip keeps type and pixelsNew PassednominallosslessAdded 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. -
byte/bil: VICAR to VICAR round trip keeps type and pixelsNew PassednominallosslessAdded 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. -
byte/bip: VICAR to VICAR round trip keeps type and pixelsNew PassednominallosslessAdded 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. -
half: BSQ, BIL and BIP decode to the same pixelsNew PassednominalAdded 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).
-
half/bsq: VICAR to VICAR round trip keeps type and pixelsNew PassednominallosslessAdded 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. -
half/bil: VICAR to VICAR round trip keeps type and pixelsNew PassednominallosslessAdded 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. -
half/bip: VICAR to VICAR round trip keeps type and pixelsNew PassednominallosslessAdded 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. -
full: BSQ, BIL and BIP decode to the same pixelsNew PassednominalAdded 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).
-
full/bsq: VICAR to VICAR round trip keeps type and pixelsNew PassednominallosslessAdded 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. -
full/bil: VICAR to VICAR round trip keeps type and pixelsNew PassednominallosslessAdded 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. -
full/bip: VICAR to VICAR round trip keeps type and pixelsNew PassednominallosslessAdded 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. -
real: BSQ, BIL and BIP decode to the same pixelsNew PassednominalAdded 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).
-
real/bsq: VICAR to VICAR round trip keeps type and pixelsNew PassednominallosslessAdded 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. -
real/bil: VICAR to VICAR round trip keeps type and pixelsNew PassednominallosslessAdded 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. -
real/bip: VICAR to VICAR round trip keeps type and pixelsNew PassednominallosslessAdded 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. -
doub: BSQ, BIL and BIP decode to the same pixelsNew PassednominalAdded 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).
-
doub/bsq: VICAR to VICAR round trip keeps type and pixelsNew PassednominallosslessAdded 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. -
doub/bil: VICAR to VICAR round trip keeps type and pixelsNew PassednominallosslessAdded 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. -
doub/bip: VICAR to VICAR round trip keeps type and pixelsNew PassednominallosslessAdded 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. -
degenerate shape gen_byte_ns1_nl1024.vic survives VICAR and PDS round tripsNew Passedlegacyoff-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.
-
degenerate shape gen_byte_ns1024_nl1.vic survives VICAR and PDS round tripsNew Passedlegacyoff-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.
-
degenerate shape gen_real_100x100.vic survives VICAR and PDS round tripsNew Passedlegacyoff-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.
-
jConvertIIO decodes little-endian int16 (INTFMT/REALFMT LOW)New PassednominalAdded 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. -
jConvertIIO decodes little-endian float32-bsq (INTFMT/REALFMT LOW)New PassednominalAdded 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. -
little-endian float32 BSQ, BIL and BIP agree after conversionNew PassednominalAdded 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.
-
ImageIO API decodes little-endian HALF the same as BYTE 1..24New PassednominalregressionAdded 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
-
ImageIO API decodes little-endian int16 the same on every input streamNew PassednominalregressionAdded 2026-10-24
Reads the GDAL little-endian int16 fixture (
INTFMT/REALFMT= LOW) through the Java ImageIO API twice: with the streamImageIO.createImageInputStreampicks (imageio-ext's file stream in the FAT jar) and with the JDKFileImageInputStream. 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
-
ImageIO API decodes little-endian int32 the same on every input streamNew PassednominalregressionAdded 2026-10-24
Reads the GDAL little-endian int32 fixture (
INTFMT/REALFMT= LOW) through the Java ImageIO API twice: with the streamImageIO.createImageInputStreampicks (imageio-ext's file stream in the FAT jar) and with the JDKFileImageInputStream. 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
-
ImageIO API decodes little-endian float32-bsq the same on every input streamNew PassednominalregressionAdded 2026-10-24
Reads the GDAL little-endian float32-bsq fixture (
INTFMT/REALFMT= LOW) through the Java ImageIO API twice: with the streamImageIO.createImageInputStreampicks (imageio-ext's file stream in the FAT jar) and with the JDKFileImageInputStream. 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
-
ImageIO API decodes little-endian float64 the same on every input streamNew PassednominalregressionAdded 2026-10-24
Reads the GDAL little-endian float64 fixture (
INTFMT/REALFMT= LOW) through the Java ImageIO API twice: with the streamImageIO.createImageInputStreampicks (imageio-ext's file stream in the FAT jar) and with the JDKFileImageInputStream. 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
-
reads bigendian-int16 (system label with DAT_TIM/BINC)New Passedmalformed-inputregressionAdded 2026-10-22, modified 2026-10-24
Reads the GDAL bigendian-int16 fixture, whose system label has
DAT_TIMandBINCitems (a history task whoseTASKkeyword 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 orphanedDAT_TIMin a history task namedUNKNOWN.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
-
reads bigendian-float32 (system label with DAT_TIM/BINC)New Passedmalformed-inputregressionAdded 2026-10-22, modified 2026-10-24
Reads the GDAL bigendian-float32 fixture, whose system label has
DAT_TIMandBINCitems (a history task whoseTASKkeyword 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 orphanedDAT_TIMin a history task namedUNKNOWN.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
-
reads vax-float32 (system label with DAT_TIM/BINC)New Passedmalformed-inputregressionAdded 2026-10-22, modified 2026-10-24
Reads the GDAL vax-float32 fixture, whose system label has
DAT_TIMandBINCitems (a history task whoseTASKkeyword 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 orphanedDAT_TIMin a history task namedUNKNOWN.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
-
big-endian and VAX float32 fixtures decode to the same valuesNew Passedmalformed-inputregressionAdded 2026-10-24
Reads the GDAL big-endian IEEE and VAX float32 fixtures (both with the misplaced
DAT_TIMlabel item). Passes when the two decode to identical pixels.Issue REVIEW-2: fixed: these files could not be opened at all
-
jConvertIIO decodes little-endian DOUB (float64) and FULL (int32) fixturesNew PassednominalAdded 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.
-
binary line prefix fixture decodes to its 1x1 imageNew PassednominalAdded 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).
-
truncated VICAR file fails with a non-zero exitNew Passedmalformed-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
-
malformedLabelFailsWithIIOExceptionForWidthNew PassedunitUnit tests (JUnit): VicarImageReaderLabelErrorTestAdded 2026-10-24
Imports the result of the JUnit test
VicarImageReaderLabelErrorTest.malformedLabelFailsWithIIOExceptionForWidthfrom the Maven build (target/surefire-reports). Passes when it passed in JUnit; a JUnit failure is shown with its message. -
malformedLabelFailsWithIIOExceptionNew PassedunitUnit tests (JUnit): VicarImageReaderLabelErrorTestAdded 2026-10-24
Imports the result of the JUnit test
VicarImageReaderLabelErrorTest.malformedLabelFailsWithIIOExceptionfrom the Maven build (target/surefire-reports). Passes when it passed in JUnit; a JUnit failure is shown with its message. -
littleEndianFileOnBigEndianStreamNew PassedunitUnit tests (JUnit): ImageInputStreamStrideTestAdded 2026-10-24
Imports the result of the JUnit test
ImageInputStreamStrideTest.littleEndianFileOnBigEndianStreamfrom the Maven build (target/surefire-reports). Passes when it passed in JUnit; a JUnit failure is shown with its message. -
littleEndianThroughImageioExtStreamNew PassedunitUnit tests (JUnit): ImageInputStreamStrideTestAdded 2026-10-24
Imports the result of the JUnit test
ImageInputStreamStrideTest.littleEndianThroughImageioExtStreamfrom the Maven build (target/surefire-reports). Passes when it passed in JUnit; a JUnit failure is shown with its message. -
directPathOnlyForStreamsThatHonourByteOrderNew PassedunitUnit tests (JUnit): ImageInputStreamStrideTestAdded 2026-10-24
Imports the result of the JUnit test
ImageInputStreamStrideTest.directPathOnlyForStreamsThatHonourByteOrderfrom the Maven build (target/surefire-reports). Passes when it passed in JUnit; a JUnit failure is shown with its message. -
bigEndianThroughImageioExtStreamNew PassedunitUnit tests (JUnit): ImageInputStreamStrideTestAdded 2026-10-24
Imports the result of the JUnit test
ImageInputStreamStrideTest.bigEndianThroughImageioExtStreamfrom the Maven build (target/surefire-reports). Passes when it passed in JUnit; a JUnit failure is shown with its message. -
littleEndianThroughJdkStreamNew PassedunitUnit tests (JUnit): ImageInputStreamStrideTestAdded 2026-10-24
Imports the result of the JUnit test
ImageInputStreamStrideTest.littleEndianThroughJdkStreamfrom the Maven build (target/surefire-reports). Passes when it passed in JUnit; a JUnit failure is shown with its message. -
programmaticAddStillRejectsUserInPropertyLabelNew PassedunitUnit tests (JUnit): VicarLabelTestAdded 2026-10-24
Imports the result of the JUnit test
VicarLabelTest.programmaticAddStillRejectsUserInPropertyLabelfrom the Maven build (target/surefire-reports). Passes when it passed in JUnit; a JUnit failure is shown with its message. -
readMovesUserOutOfPropertySetNew PassedunitUnit tests (JUnit): VicarLabelTestAdded 2026-10-24
Imports the result of the JUnit test
VicarLabelTest.readMovesUserOutOfPropertySetfrom the Maven build (target/surefire-reports). Passes when it passed in JUnit; a JUnit failure is shown with its message. -
testPassedunitUnit tests (JUnit): VicarLabelTestAdded 2026-06-18
Imports the result of the JUnit test
VicarLabelTest.testfrom the Maven build (target/surefire-reports). Passes when it passed in JUnit; a JUnit failure is shown with its message. -
programmaticAddStillRejectsDatTimInSystemLabelNew PassedunitUnit tests (JUnit): VicarLabelTestAdded 2026-10-24
Imports the result of the JUnit test
VicarLabelTest.programmaticAddStillRejectsDatTimInSystemLabelfrom the Maven build (target/surefire-reports). Passes when it passed in JUnit; a JUnit failure is shown with its message. -
readKeepsOrphanedHistoryItemsInUnknownTaskNew PassedunitUnit tests (JUnit): VicarLabelTestAdded 2026-10-24
Imports the result of the JUnit test
VicarLabelTest.readKeepsOrphanedHistoryItemsInUnknownTaskfrom the Maven build (target/surefire-reports). Passes when it passed in JUnit; a JUnit failure is shown with its message. -
class is listed under a feature in features.ymlNew PassedsuiteUnit tests (JUnit): VicarImageReaderLabelErrorTestAdded 2026-10-24
Bookkeeping, not a product test: checks that the JUnit class
jpl.mipl.io.plugins.VicarImageReaderLabelErrorTestis listed in a feature'sjunit:list in features.yml, so its results are grouped under that feature. -
class is listed under a feature in features.ymlNew PassedsuiteUnit tests (JUnit): ImageInputStreamStrideTestAdded 2026-10-24, modified 2026-10-28
Bookkeeping, not a product test: checks that the JUnit class
jpl.mipl.io.streams.ImageInputStreamStrideTestis listed in a feature'sjunit:list in features.yml, so its results are grouped under that feature. -
class is listed under a feature in features.ymlModified PassedsuiteUnit tests (JUnit): VicarLabelTestAdded 2026-06-18, modified 2026-10-24
Bookkeeping, not a product test: checks that the JUnit class
jpl.mipl.io.vicar.VicarLabelTestis listed in a feature'sjunit: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
-
Cassini ISS image (NLB=1, NBB=24) decodes identically with RI=trueNew Passedmission-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 withRI=true(read as a RenderedImage). Passes when the pixels match the recorded golden hash and the output has the same pixels. -
KEEP_LINE_PREFIX=true carries the prefixes into PDS outputNew Passedmission-datalosslessAdded 2026-10-23
Converts the Cassini ISS image to PDS3 with
KEEP_LINE_PREFIX=true. Passes when the label declaresLINE_PREFIX_BYTES = 24, the first 8 line prefixes are byte for byte those of the input, and the pixels are unchanged. -
KEEP_LINE_PREFIX=true carries the prefixes into VICAR outputNew Passedmission-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 hasNBB=24,RECSIZE=2072and the input'sBLTYPE/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, theADD_BINARY_HEADERdefault), and the pixels are unchanged.Issue REVIEW-13: fixed: VICAR output dropped the line prefixes (NBB=0) even with KEEP_LINE_PREFIX=true
-
VICAR output keeps the line prefixes by defaultNew Passedmission-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 hasNBB=24and 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
-
KEEP_LINE_PREFIX=false strips the prefixes from VICAR outputNew Passedmission-datalosslessAdded 2026-10-23, modified 2026-10-24
Converts the Cassini ISS image to VICAR with
KEEP_LINE_PREFIX=false. Passes when the output hasNBB=0andRECSIZE=2048(1024 HALF samples, no prefix) and the pixels are unchanged. -
ADD_BINARY_HEADER=true writes the binary header to VICAR outputNew Passedmission-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 hasNLB=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
-
ADD_BINARY_HEADER=true with KEEP_LINE_PREFIX=false fits the header to the shorter recordsNew Passedmission-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 hasNLB=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
-
prefixes are not written when SOURCE_REGION drops linesNew Passedmission-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 withNBB=0, a warning saying the prefixes were not written, and the output is 1024 x 100. -
KEEP_LINE_PREFIX and ADD_BINARY_HEADER are harmless without binary dataNew Passedoff-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 hasNBB=0andNLB=0and the pixels are unchanged. -
prefixes do not follow the wrong band when BANDS reorders the bandsNew Passedoff-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)andKEEP_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
-
BANDS that keeps every band in place keeps the prefixesNew PassednominallosslessAdded 2026-10-28
Converts the same synthetic 3-band prefixed image to VICAR with
BANDS=(0,1,2)andKEEP_LINE_PREFIX=true. Passes when the output keepsNBB=4and every record's prefix is the input's for the same band and line. -
headerWithoutPrefixesReblocksWhenDataWouldBeCutNew PassedunitUnit tests (JUnit): VicarImageWriterBinaryTestAdded 2026-10-24
Imports the result of the JUnit test
VicarImageWriterBinaryTest.headerWithoutPrefixesReblocksWhenDataWouldBeCutfrom the Maven build (target/surefire-reports). Passes when it passed in JUnit; a JUnit failure is shown with its message. -
noParamWritesNoBinaryDataNew PassedunitUnit tests (JUnit): VicarImageWriterBinaryTestAdded 2026-10-24
Imports the result of the JUnit test
VicarImageWriterBinaryTest.noParamWritesNoBinaryDatafrom the Maven build (target/surefire-reports). Passes when it passed in JUnit; a JUnit failure is shown with its message. -
dropsPrefixesWhenLineCountChangedNew PassedunitUnit tests (JUnit): VicarImageWriterBinaryTestAdded 2026-10-24
Imports the result of the JUnit test
VicarImageWriterBinaryTest.dropsPrefixesWhenLineCountChangedfrom the Maven build (target/surefire-reports). Passes when it passed in JUnit; a JUnit failure is shown with its message. -
keepsPrefixesAndHeaderNew PassedunitUnit tests (JUnit): VicarImageWriterBinaryTestAdded 2026-10-24
Imports the result of the JUnit test
VicarImageWriterBinaryTest.keepsPrefixesAndHeaderfrom the Maven build (target/surefire-reports). Passes when it passed in JUnit; a JUnit failure is shown with its message. -
keepsPrefixesOnlyNew PassedunitUnit tests (JUnit): VicarImageWriterBinaryTestAdded 2026-10-24
Imports the result of the JUnit test
VicarImageWriterBinaryTest.keepsPrefixesOnlyfrom the Maven build (target/surefire-reports). Passes when it passed in JUnit; a JUnit failure is shown with its message. -
headerWithoutPrefixesTruncatesZeroTailNew PassedunitUnit tests (JUnit): VicarImageWriterBinaryTestAdded 2026-10-24
Imports the result of the JUnit test
VicarImageWriterBinaryTest.headerWithoutPrefixesTruncatesZeroTailfrom the Maven build (target/surefire-reports). Passes when it passed in JUnit; a JUnit failure is shown with its message. -
class is listed under a feature in features.ymlNew PassedsuiteUnit tests (JUnit): VicarImageWriterBinaryTestAdded 2026-10-24
Bookkeeping, not a product test: checks that the JUnit class
jpl.mipl.io.plugins.VicarImageWriterBinaryTestis listed in a feature'sjunit: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
-
VICAR to PDS3 writes a valid label and keeps pixelsNew PassednominallosslessAdded 2026-10-22, modified 2026-10-23
Converts the synthetic 3-band BYTE image to PDS3. Passes when the label is valid (PDS3 version,
^IMAGEpointer, an IMAGE object with the right LINES, LINE_SAMPLES and BANDS, no empty""values) and the pixels are unchanged. -
EMBED_VICAR_LABEL=true embeds the VICAR labelNew PassednominallosslessAdded 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. -
PDS_FILENAME_IN_LABEL=true puts the output file name in the labelNew PassednominalregressionlosslessAdded 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^IMAGEpointer 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
-
PDS_FILENAME (older spelling) still puts the file name in the labelNew PassednominalregressionAdded 2026-10-24
Converts the synthetic image to PDS3 with
PDS_FILENAME=true, the only spelling the parser accepted before. Passes when the^IMAGEpointer names the output file.Issue REVIEW-9: PDS_FILENAME is kept as an alias of PDS_FILENAME_IN_LABEL
-
without PDS_FILENAME_IN_LABEL, or with =false, the label names no fileNew Passedoff-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 = nand do not contain the output file name.Issue REVIEW-9: the file name is opt-in; the default attached label is unchanged
-
PDS_LABEL_TYPE=ODL3 writes an ODL3 labelNew PassednominalAdded 2026-10-22, modified 2026-10-23
Converts the synthetic image to PDS3 with
PDS_LABEL_TYPE=ODL3. Passes when the label starts withODL_VERSION_ID = ODL3and is otherwise valid. -
reads an MSL Navcam EDR thumbnail (attached PDS3 + VICAR labels)New Passedmission-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.
-
reads an MSL Navcam EDR through its detached .LBLNew Passedmission-dataregressionlosslessAdded 2026-10-22, modified 2026-10-24
Converts the same MSL thumbnail by giving jConvertIIO its detached
.LBLlabel 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"
-
namespaced PDS3 keywords (MSL:...) become legal VICAR keywordsNew Passedmission-dataregressionAdded 2026-10-22, modified 2026-10-24
Converts the MSL thumbnail's detached
.LBL, which uses namespaced keywords such asMSL: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.IMGpixels.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'")
-
PDS-labelled input to FORMAT=pds with the default stylesheetNew Passedmission-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)
-
PDS-labelled input to FORMAT=pds with an explicit copy stylesheetNew Passedmission-datalosslessAdded 2026-10-22, modified 2026-10-23
Same conversion with
XSL=CopyEverything.xslgiven explicitly. Passes when the output label has an^IMAGEpointer and the pixels are unchanged.Issue IDS-8497: an explicit copy stylesheet gives the same result as the default
-
MSL Navcam full EDR reads and round-trips through VICARNew Passedmission-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.
-
MER Opportunity Navcam EDR reads (stand-in for the legacy mer_file.vic)New Passedmission-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.vicof the legacy test. Passes when the pixels match the recorded golden hash. -
Cassini ISS: VICAR image and its detached PDS3 label decode identicallyNew Passedmission-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^IMAGEpoints at the image). Passes when both match the recorded golden hash. -
fileChannelStreamSeekPastEndReadsEofNew PassedunitUnit tests (JUnit): PDS3DetachedLabelTestAdded 2026-10-24
Imports the result of the JUnit test
PDS3DetachedLabelTest.fileChannelStreamSeekPastEndReadsEoffrom the Maven build (target/surefire-reports). Passes when it passed in JUnit; a JUnit failure is shown with its message. -
headerPointerAtStartOfDataFileKeepsVicarLabelNew PassedunitUnit tests (JUnit): PDS3DetachedLabelTestAdded 2026-10-24
Imports the result of the JUnit test
PDS3DetachedLabelTest.headerPointerAtStartOfDataFileKeepsVicarLabelfrom the Maven build (target/surefire-reports). Passes when it passed in JUnit; a JUnit failure is shown with its message. -
headerPointerPastEndOfLabelFileNew PassedunitUnit tests (JUnit): PDS3DetachedLabelTestAdded 2026-10-24
Imports the result of the JUnit test
PDS3DetachedLabelTest.headerPointerPastEndOfLabelFilefrom the Maven build (target/surefire-reports). Passes when it passed in JUnit; a JUnit failure is shown with its message. -
noImageObjectProducesEmptySystemLabelPassedunitUnit tests (JUnit): PDS3ObjectNameTestAdded 2026-05-27
Imports the result of the JUnit test
PDS3ObjectNameTest.noImageObjectProducesEmptySystemLabelfrom the Maven build (target/surefire-reports). Passes when it passed in JUnit; a JUnit failure is shown with its message. -
readsRflImageWithExplicitParamPassedunitUnit tests (JUnit): PDS3ObjectNameTestAdded 2026-05-27
Imports the result of the JUnit test
PDS3ObjectNameTest.readsRflImageWithExplicitParamfrom the Maven build (target/surefire-reports). Passes when it passed in JUnit; a JUnit failure is shown with its message. -
readsRflImageViaHeuristicWhenParamUnsetPassedunitUnit tests (JUnit): PDS3ObjectNameTestAdded 2026-05-27
Imports the result of the JUnit test
PDS3ObjectNameTest.readsRflImageViaHeuristicWhenParamUnsetfrom the Maven build (target/surefire-reports). Passes when it passed in JUnit; a JUnit failure is shown with its message. -
readsStandardImageObjectPassedunitUnit tests (JUnit): PDS3ObjectNameTestAdded 2026-05-27
Imports the result of the JUnit test
PDS3ObjectNameTest.readsStandardImageObjectfrom the Maven build (target/surefire-reports). Passes when it passed in JUnit; a JUnit failure is shown with its message. -
class is listed under a feature in features.ymlNew PassedsuiteUnit tests (JUnit): PDS3DetachedLabelTestAdded 2026-10-24
Bookkeeping, not a product test: checks that the JUnit class
jpl.mipl.io.vicar.PDS3DetachedLabelTestis listed in a feature'sjunit:list in features.yml, so its results are grouped under that feature. -
class is listed under a feature in features.ymlPassedsuiteUnit tests (JUnit): PDS3ObjectNameTestAdded 2026-05-27
Bookkeeping, not a product test: checks that the JUnit class
jpl.mipl.io.vicar.PDS3ObjectNameTestis listed in a feature'sjunit: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
-
XSL=- uses the default stylesheet from the jarNew PassednominallosslessAdded 2026-10-22, modified 2026-10-23
Converts the synthetic image to PDS3 with
XSL=-(the default stylesheet in the jar) andEMBED_VICAR_LABEL=true. Passes when the label is valid and the pixels are unchanged. -
legacy recipe: XML=false, VicarToPDSmer1.xsl, EMBED_VICAR_LABEL=trueNew PassedlegacynominalAdded 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. -
all 23 bundled VicarToPDS stylesheets produce valid labelsNew PassednominallosslessAdded 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.
-
legacy normal.pds recipe on a public MER EDR (via VICAR)New Passedlegacymission-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. -
VICAR-to-PDS stylesheet on a PDS-labelled MER EDRNew Passedlegacymission-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.viccase 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
-
PDS4 label and attached label decode the same pixelsNew Passedmission-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.
-
jConvertIIO converts a PDS4 label to TIFF and VICARNew Passedmission-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.
-
a relative PDS4 label path resolves its data file next to the labelNew Passedmission-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.
-
Mars 2020 Navcam full EDR via PDS4 labelNew Passedmission-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
-
character table to CSV: header plus every record, values intactNew PassednominalAdded 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. -
character table to fixed-width textNew PassednominalAdded 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. -
without -o the table is written to stdoutNew Passedoff-nominalregressionAdded 2026-10-23, modified 2026-10-26
Runs
ExtractTableJPL -cwithout-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
-
--list-tables without -o lists the table and its fields on stdoutNew PassednominalregressionAdded 2026-10-23, modified 2026-10-26
Runs
ExtractTableJPL --list-tableswithout-oon 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
-
-h prints the usage and exits 0New PassednominalregressionAdded 2026-10-26
Runs
ExtractTableJPL -h. Passes when exit is 0, stdout holds the usage text (including the--output-fileoption) and there is no exception.Issue NEW-pds4-1: fixed: showHelp did not exit, so -h fell through and ended in ArrayIndexOutOfBoundsException
-
no label file: usage message and a non-zero exitNew Passedoff-nominalregressionAdded 2026-10-23, modified 2026-10-26
Runs
ExtractTableJPL -cwith 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
-
delimited (CSV) tableNew Known issuenominalAdded 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)
-
delimited table: clean "not supported in this build" errorNew Passedoff-nominalregressionAdded 2026-10-23, modified 2026-10-26
Exports the delimited (CSV) table with
ExtractTableJPL -cand 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
-
jConvertIIO PDS4_TABLE_OUTPUT_FORMAT=csv exports the tableNew PassednominalregressionAdded 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
-
jConvertIIO accepts the old PDS4_TABLE_OUPUT_FORMAT spellingNew Passedoff-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
-
jConvertIIO PDS4_TABLE_OUTPUT_FORMAT=fixed-width exports fixed-width textNew PassednominalregressionAdded 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
-
jConvertIIO table export defaults to fixed-width, as HELP documentsNew PassednominalregressionAdded 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
-
jConvertIIO PDS4_TABLE_LIST=true lists the tables and fieldsNew PassednominalregressionAdded 2026-10-26
Runs jConvertIIO with
PDS4_TABLE_LIST=trueon 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
-
jConvertIIO PDS4_TABLE_FIELDS selects fieldsNew PassednominalAdded 2026-10-23, modified 2026-10-26
Exports the character table through jConvertIIO with
PDS4_TABLE_OUTPUT_FORMAT=csvandPDS4_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. -
jConvertIIO PDS4_TABLE_INDEX selects the second tableNew PassednominalregressionAdded 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
-
jConvertIIO TABLE_FIELD_SEPARATOR sets the field separatorNew PassednominalregressionAdded 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
-
reading a PDS4 table label logs no XPath namespace errorNew Passedoff-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
-
reads the Cassini VIMS cube and converts it to VICARNew Passednominalregressionmission-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
-
reads the GDAL ISIS2 cube and converts it to VICARNew PassednominalregressionAdded 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
-
a cube whose CORE_ITEMS is not a list of integers fails with a clear errorNew Passedoff-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
-
cachedStreamIsNotRandomAccessEasyNew PassedunitUnit tests (JUnit): ReaderSelectionTestAdded 2026-10-24
Imports the result of the JUnit test
ReaderSelectionTest.cachedStreamIsNotRandomAccessEasyfrom the Maven build (target/surefire-reports). Passes when it passed in JUnit; a JUnit failure is shown with its message. -
isisReaderIsOfferedBeforePdsReaderNew PassedunitUnit tests (JUnit): ReaderSelectionTestAdded 2026-10-24
Imports the result of the JUnit test
ReaderSelectionTest.isisReaderIsOfferedBeforePdsReaderfrom the Maven build (target/surefire-reports). Passes when it passed in JUnit; a JUnit failure is shown with its message. -
seekableFileStreamsAreRandomAccessNew PassedunitUnit tests (JUnit): ReaderSelectionTestAdded 2026-10-24
Imports the result of the JUnit test
ReaderSelectionTest.seekableFileStreamsAreRandomAccessfrom the Maven build (target/surefire-reports). Passes when it passed in JUnit; a JUnit failure is shown with its message. -
class is listed under a feature in features.ymlNew PassedsuiteUnit tests (JUnit): ReaderSelectionTestAdded 2026-10-24, modified 2026-10-28
Bookkeeping, not a product test: checks that the JUnit class
jpl.mipl.io.plugins.ReaderSelectionTestis listed in a feature'sjunit: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
-
reads HorseHead.fits and converts it to VICAR and TIFFNew Passedmission-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
-
F-BIDR reader decodes the orbit 378 image stripNew Passedmission-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
FileImageInputStreamand 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
-
jConvertIIO converts the F-BIDR to VICARNew Passedmission-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
-
FORMAT=tif (#01)New PassedlegacylosslessAdded 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. -
FORMAT=tiff (#02)New PassedlegacylosslessAdded 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. -
FORMAT=TIF (#03)New PassedlegacylosslessAdded 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. -
FORMAT=TIFF (#04)New PassedlegacylosslessAdded 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. -
FORMAT=png (#05)New PassedlegacylosslessAdded 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. -
FORMAT=PNG (#06)New PassedlegacylosslessAdded 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. -
FORMAT=jpeg2000 (#07)New PassedlegacylosslessAdded 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. -
FORMAT=JPEG2000 (#08)New PassedlegacylosslessAdded 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. -
FORMAT=JPEG 2000 (#09)New PassedlegacylosslessAdded 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. -
FORMAT=jpeg 2000 (#10)New PassedlegacylosslessAdded 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. -
FORMAT=pds (#11)New PassedlegacylosslessAdded 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. -
FORMAT=vicar (#12)New PassedlegacylosslessAdded 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. -
FORMAT=jpg (#13)New PassedlegacynominalAdded 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). -
FORMAT=JPG (#14)New PassedlegacynominalAdded 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). -
FORMAT=jpeg (#15)New PassedlegacynominalAdded 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). -
FORMAT=JPEG (#16)New PassedlegacynominalAdded 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). -
FORMAT=raw (#17)New PassedlegacynominallosslessregressionAdded 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
-
FORMAT=RAW (#18)New PassedlegacynominallosslessregressionAdded 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
-
FORMAT=bmp (#19)New PassedlegacylosslessregressionAdded 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
-
FORMAT=BMP (#20)New PassedlegacylosslessregressionAdded 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
-
FORMAT=pnm (#21)New PassedlegacynominallosslessregressionAdded 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
-
FORMAT=PNM (#22)New PassedlegacynominallosslessregressionAdded 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
-
FORMAT=jfif (#23)New PassedlegacynominalAdded 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). -
FORMAT=JFIF (#24)New PassedlegacynominalAdded 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). -
FORMAT=jpeg-ls (#25)New Known issuelegacyoff-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
-
FORMAT=JPEG-LS (#26)New Known issuelegacyoff-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
-
FORMAT=jpeg-lossless (#27)New Known issuelegacyoff-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
-
FORMAT=JPEG-LOSSLESS (#28)New Known issuelegacyoff-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
-
FORMAT=isis (#29)New Known issuelegacyoff-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
-
RAW output of gen_byte_bil.vic is exactly its samples, band sequentialNew PassednominallosslessregressionAdded 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
-
RAW output of gen_byte_bip.vic is exactly its samples, band sequentialNew PassednominallosslessregressionAdded 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
-
RAW output of gen_byte_gray.vic is exactly its samples, band sequentialNew PassednominallosslessregressionAdded 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
-
RAW output of gen_half_bsq.vic is exactly its samples, band sequentialNew PassednominallosslessregressionAdded 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
-
RAW output of gen_real_100x100.vic is exactly its samples, band sequentialNew Passedoff-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
-
RAW output of gen_byte_ns1_nl1024.vic is exactly its samples, band sequentialNew Passedoff-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
-
BMP output of a band-interleaved-by-line (BIL) image keeps its pixelsNew PassednominallosslessregressionAdded 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
-
HALF input to BMP without OFORM is refused with a non-zero exitNew Passedoff-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". -
a writer that crashes fails the conversion cleanlyNew Passedoff-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
-
PNM output of gen_byte_gray.vic keeps its pixelsNew PassednominallosslessregressionAdded 2026-10-24
Converts the synthetic 1-band BYTE image as an 8-bit PGM (
P5, maxval 255) withFORMAT=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
-
PNM output of gen_half_bsq.vic keeps its pixelsNew PassednominallosslessregressionAdded 2026-10-24
Converts the synthetic 3-band HALF (16-bit) image as a 16-bit PPM (
P6, maxval 65535, big-endian) withFORMAT=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
-
PNM output of gen_real_bsq.vic is refused with a messageNew Passedoff-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". -
PNM output of gen_byte_rgba.vic is refused with a messageNew Passedoff-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". -
a PNM file written by jConvertIIO can be read back as inputNew Known issueoff-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
-
a TIFF file written by jConvertIIO can be read back as inputNew PassednominallosslessregressionAdded 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"
-
HALF input to FORMAT=tif is losslessNew PassednominallosslessAdded 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. -
HALF input to FORMAT=png is losslessNew PassednominallosslessAdded 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. -
HALF input to FORMAT=jpeg2000 is losslessNew PassednominallosslessAdded 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. -
HALF input to FORMAT=pds is losslessNew PassednominallosslessAdded 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. -
HALF input to FORMAT=vicar is losslessNew PassednominallosslessAdded 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. -
REAL input to FORMAT=tif is losslessNew PassednominallosslessAdded 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. -
REAL input to FORMAT=pds is losslessNew PassednominallosslessAdded 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. -
REAL input to FORMAT=vicar is losslessNew PassednominallosslessAdded 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. -
a FORMAT with no registered writer is refused with a messageNew Passedoff-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. -
REAL input to PNG without OFORM is refused with a non-zero exitNew Passedoff-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. -
HALF input to JPEG without OFORM is refused with a non-zero exitNew Passedoff-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
-
preferOverRemovesTheJaiImageioWriterNew PassedunitUnit tests (JUnit): PNMImageWriterTestAdded 2026-10-24
Imports the result of the JUnit test
PNMImageWriterTest.preferOverRemovesTheJaiImageioWriterfrom the Maven build (target/surefire-reports). Passes when it passed in JUnit; a JUnit failure is shown with its message. -
writesEightBitGrayAsP5New PassedunitUnit tests (JUnit): PNMImageWriterTestAdded 2026-10-24
Imports the result of the JUnit test
PNMImageWriterTest.writesEightBitGrayAsP5from the Maven build (target/surefire-reports). Passes when it passed in JUnit; a JUnit failure is shown with its message. -
writesSixteenBitRgbAsBigEndianP6New PassedunitUnit tests (JUnit): PNMImageWriterTestAdded 2026-10-24
Imports the result of the JUnit test
PNMImageWriterTest.writesSixteenBitRgbAsBigEndianP6from the Maven build (target/surefire-reports). Passes when it passed in JUnit; a JUnit failure is shown with its message. -
refusesFourBandsNew PassedunitUnit tests (JUnit): PNMImageWriterTestAdded 2026-10-24
Imports the result of the JUnit test
PNMImageWriterTest.refusesFourBandsfrom the Maven build (target/surefire-reports). Passes when it passed in JUnit; a JUnit failure is shown with its message. -
class is listed under a feature in features.ymlNew PassedsuiteUnit tests (JUnit): PNMImageWriterTestAdded 2026-10-24
Bookkeeping, not a product test: checks that the JUnit class
jpl.mipl.io.plugins.PNMImageWriterTestis listed in a feature'sjunit: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
-
REAL to PNG with OFORM=BYTE is stretched, not blankNew PassednominallegacyregressionAdded 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
-
REAL to BYTE with RESCALE=false keeps the values (0..74)New PassednominalAdded 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. -
HALF to BYTE with the default RESCALE fills the byte rangeNew PassednominalAdded 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).
-
BYTE to HALF with RESCALE=false is exactNew PassednominallosslessAdded 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. -
BYTE to REAL with RESCALE=false keeps the valuesNew PassednominalAdded 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. -
BYTE to HALF with the default RESCALE keeps the valuesNew PassednominalregressionlosslessAdded 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
-
BYTE to REAL with the default RESCALE keeps the valuesNew PassednominalregressionAdded 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
-
HALF to HALF with the default RESCALE keeps the valuesNew PassednominalregressionlosslessAdded 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
-
BYTE to HALF with RESCALE_CONSTANT and RESCALE_OFFSET is not clipped to the byte rangeNew PassednominalregressionAdded 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
-
HALF to BYTE with VALID_MINIMUM and VALID_MAXIMUM stretches that range to 0..255New Passedoff-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. -
HALF to BYTE with the default RESCALE reaches 255New PassednominalregressionAdded 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
-
BYTE to BYTE with OFORM=BYTE keeps the valuesNew PassednominalregressionlosslessAdded 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
-
CLAMP=(10,100) limits the output rangeNew PassednominalAdded 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. -
12-bit MER EDR to an 8-bit PNG browse imageNew Passedmission-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
-
SOURCE_REGION=(x,y,width,height) cuts out exactly that regionNew PassednominalAdded 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. -
SOURCE_REGION running past the image edge is clipped, not an errorNew Passedoff-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
-
SUBSAMPLING=(2,2,0,0) keeps every Nth sample and lineNew PassednominalregressionAdded 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
-
SUBSAMPLING=(3,2,1,1) keeps every Nth sample and lineNew PassednominalregressionAdded 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
-
CROP=(x,y,width,height) to png cuts out exactly that areaNew PassednominalregressionAdded 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
-
CROP=(x,y,width,height) to vicar cuts out exactly that areaNew PassednominalregressionAdded 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
-
CROP=(x,y) crops from (x,y) to the image edgeNew PassednominalregressionAdded 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"
-
CROP outside the image is refused with a clear errorNew Passedoff-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. -
SCALE=(2,2,0,0) doubles the image sizeNew PassednominalAdded 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. -
READ_BANDS selects bands on readNew PassednominalAdded 2026-10-23
Reads only some bands, with
READ_BANDS=2and withREAD_BANDS=0,2. Passes when each output has exactly those bands, with the pixel hash computed for them. -
BANDS reorders bands (2,1,0 twice restores the original)New PassednominallosslessAdded 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. -
2RGB=true turns a single band into gray RGBNew PassednominalAdded 2026-10-23
Writes a single-band image to PNG with
2RGB=trueand with2RGB=false. Passes when the first PNG is RGB with the gray value in all three bands and the second is a gray PNG. -
WRITE_TRANSPARENCY writes the fourth band as PNG alphaNew PassednominallosslessAdded 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
-
XML=true writes the label DOM as XML debug documentsNew PassednominalAdded 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). -
a DOCTYPE with a missing external DTD parses; the DTD is never loadedNew Passedsecuritymalformed-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
-
external entities are not resolved (no file read, no error)New Passedsecuritymalformed-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
-
an XSL stylesheet cannot read files through external entitiesNew Passedsecuritymalformed-inputregressionAdded 2026-10-27
Converts the synthetic image to PDS3 with
XSL=set to a copy ofVicarToPDSmer1.xslthat declares an external entity reading a local "secret" file and writes it into aLEAKlabel 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
-
an XSL stylesheet cannot read files with document(), write files or call JavaNew Passedsecuritymalformed-inputregressionAdded 2026-11-11
Converts the synthetic image to PDS3 with
XSL=set to a copy ofVicarToPDSmer1.xslthat adds aLEAKlabel item filled bydocument()from a local "secret" XML file, aJAVAitem filled by a Xalan Java extension call that builds a marker string, and a Xalanredirect:writethat 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
-
externalParameterEntityIsNotResolvedNew PassedunitUnit tests (JUnit): DOMutilsXXETestAdded 2026-10-21
Imports the result of the JUnit test
DOMutilsXXETest.externalParameterEntityIsNotResolvedfrom the Maven build (target/surefire-reports). Passes when it passed in JUnit; a JUnit failure is shown with its message. -
externalDtdIsNotLoadedNew PassedunitUnit tests (JUnit): DOMutilsXXETestAdded 2026-10-21
Imports the result of the JUnit test
DOMutilsXXETest.externalDtdIsNotLoadedfrom the Maven build (target/surefire-reports). Passes when it passed in JUnit; a JUnit failure is shown with its message. -
factoryHasXXEFeaturesDisabledNew PassedunitUnit tests (JUnit): DOMutilsXXETestAdded 2026-10-21
Imports the result of the JUnit test
DOMutilsXXETest.factoryHasXXEFeaturesDisabledfrom the Maven build (target/surefire-reports). Passes when it passed in JUnit; a JUnit failure is shown with its message. -
stylesheetDocumentFunctionCannotReadFilesNew PassedunitUnit tests (JUnit): DOMutilsXXETestAdded 2026-11-11
Imports the result of the JUnit test
DOMutilsXXETest.stylesheetDocumentFunctionCannotReadFilesfrom the Maven build (target/surefire-reports). Passes when it passed in JUnit; a JUnit failure is shown with its message. -
stylesheetIncludeCannotReadFilesNew PassedunitUnit tests (JUnit): DOMutilsXXETestAdded 2026-11-11
Imports the result of the JUnit test
DOMutilsXXETest.stylesheetIncludeCannotReadFilesfrom the Maven build (target/surefire-reports). Passes when it passed in JUnit; a JUnit failure is shown with its message. -
stylesheetStillTransformsNew PassedunitUnit tests (JUnit): DOMutilsXXETestAdded 2026-10-27
Imports the result of the JUnit test
DOMutilsXXETest.stylesheetStillTransformsfrom the Maven build (target/surefire-reports). Passes when it passed in JUnit; a JUnit failure is shown with its message. -
literalResultElementsKeepTheirAttributesNew PassedunitUnit tests (JUnit): DOMutilsXXETestAdded 2026-11-11
Imports the result of the JUnit test
DOMutilsXXETest.literalResultElementsKeepTheirAttributesfrom the Maven build (target/surefire-reports). Passes when it passed in JUnit; a JUnit failure is shown with its message. -
namespacedLabelStillParsesNew PassedunitUnit tests (JUnit): DOMutilsXXETestAdded 2026-10-21
Imports the result of the JUnit test
DOMutilsXXETest.namespacedLabelStillParsesfrom the Maven build (target/surefire-reports). Passes when it passed in JUnit; a JUnit failure is shown with its message. -
stylesheetCannotUseRedirectToWriteFilesNew PassedunitUnit tests (JUnit): DOMutilsXXETestAdded 2026-11-11
Imports the result of the JUnit test
DOMutilsXXETest.stylesheetCannotUseRedirectToWriteFilesfrom the Maven build (target/surefire-reports). Passes when it passed in JUnit; a JUnit failure is shown with its message. -
stylesheetExternalEntityIsNotResolvedNew PassedunitUnit tests (JUnit): DOMutilsXXETestAdded 2026-10-27
Imports the result of the JUnit test
DOMutilsXXETest.stylesheetExternalEntityIsNotResolvedfrom the Maven build (target/surefire-reports). Passes when it passed in JUnit; a JUnit failure is shown with its message. -
stylesheetCannotCallJavaExtensionsNew PassedunitUnit tests (JUnit): DOMutilsXXETestAdded 2026-11-11
Imports the result of the JUnit test
DOMutilsXXETest.stylesheetCannotCallJavaExtensionsfrom the Maven build (target/surefire-reports). Passes when it passed in JUnit; a JUnit failure is shown with its message. -
externalGeneralEntityIsNotResolvedNew PassedunitUnit tests (JUnit): DOMutilsXXETestAdded 2026-10-21
Imports the result of the JUnit test
DOMutilsXXETest.externalGeneralEntityIsNotResolvedfrom the Maven build (target/surefire-reports). Passes when it passed in JUnit; a JUnit failure is shown with its message. -
class is listed under a feature in features.ymlNew PassedsuiteUnit tests (JUnit): DOMutilsXXETestAdded 2026-10-21, modified 2026-11-11
Bookkeeping, not a product test: checks that the JUnit class
jpl.mipl.io.util.DOMutilsXXETestis listed in a feature'sjunit: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
-
ARGFILE batch runs every lineNew PassednominallosslessAdded 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. -
ARGFILE batch with PARALLEL_BATCH=2 runs every lineNew PassednominallosslessAdded 2026-10-23
Runs a batch file of 3 conversions (PNG, TIFF and VICAR from different inputs) with
ARGFILEandPARALLEL_BATCH=2. Passes when the run exits 0 and every output exists with its input's pixels. -
input and output file names without extensionsNew Passedoff-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
-
OUT=- with SILENT writes the image to stdoutNew PassednominalregressionlosslessAdded 2026-10-23, modified 2026-10-24
Converts the synthetic image to PNG with
OUT=-andSILENT, 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
-
OUT=- without SILENT keeps messages off stdoutNew PassednominalregressionlosslessAdded 2026-10-23, modified 2026-10-24
Converts the synthetic image to VICAR with
OUT=-and noSILENT. Passes when the exit code is 0, the progress messages appear on stderr, and stdout holds only the VICAR file (it starts withLBLSIZE=and decodes to the input pixels).Issue REVIEW-12: fixed: with OUT=- the messages would have been mixed into the image on stdout
-
FORMAT without OUT, and OUT=- without FORMAT, are refusedNew Passedoff-nominalregressionAdded 2026-10-23, modified 2026-10-24
Runs jConvertIIO with
FORMAT=pngbut noOUT, then withOUT=-but noFORMAT. 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 "-"
-
OUT=- on an ARGFILE line is refusedNew Passedoff-nominalregressionAdded 2026-10-28
Runs an
ARGFILEbatch whose second line converts to PNG withOUT=-. Passes when the run exits non-zero with an error namingOUT=-andARGFILEon 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
-
OUT=- on an ARGFILE line is refused (PARALLEL_BATCH=2)New Passedoff-nominalregressionAdded 2026-10-28
Runs an
ARGFILEbatch withPARALLEL_BATCH=2whose second line converts to PNG withOUT=-. Passes when the run exits non-zero with an error namingOUT=-andARGFILEon 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
-
https input from the public PDS archive matches the local copyNew Passedmission-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
-
legacy step 18: PNG converted to JPEG displaysNew PassedlegacynominalAdded 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.
-
browse image of msl-navcam-thumb-img displaysNew Passedmission-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. -
browse image of m2020-navcam-thumb-img displaysNew Passedmission-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. -
browse image of cassini-iss-img displaysNew Passedmission-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. -
browse image of astropy-horsehead-fits displaysNew Passedmission-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. -
browse image of mer1-navcam-edr displaysNew Passedmission-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. -
browse image of msl-navcam-edr-img displaysNew Passedmission-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. -
browse image of m2020-navcam-edr-img displaysNew Passedmission-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
-
replace mode swaps one element and keeps the restNew PassednominalAdded 2026-10-22, modified 2026-10-23
Runs
xml_swap.pyin replace mode: replaces//pds:Ain 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. -
list mode prints structural XPathsNew PassednominalAdded 2026-10-22, modified 2026-10-23
Runs
xml_swap.py --list-xpathson a PDS4-namespaced document. Passes when it exits 0 and lists thepds:Aelement path. -
show mode does not expand external entitiesNew Passedsecuritymalformed-inputregressionAdded 2026-10-22, modified 2026-10-23
Runs
xml_swap.py --show-xpathon 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
-
build_mesh_extras.py writes the mesh extras JSON (LabelObj usage)New PassednominalAdded 2026-10-23
Runs
build_mesh_extras.pyon a mesh.mtlfile. Passes when the JSON it writes holds the solar longitude and the texture PNG list from the.mtl. -
build_mesh_extras.py refuses paths outside its folders or of the wrong typeNew Passedsecurityoff-nominalregressionAdded 2026-10-23
Runs
build_mesh_extras.pywith four bad paths: an output outside its folders (../escaped.json), an output that is not.json, and/etc/hostsas the.mtland as the base JSON. Passes when each run exits non-zero with abuild_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
-
Mars 2020 Navcam: generated label matches the archive label and reads backNew Passedmission-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:pdslogical identifier, describes the image array exactly as the official archive label does, and reads back to the same pixels. -
MSL Navcam: generated label describes and reads back the imageNew Passedmission-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
-
feature ids are unique and well formed, with a name and descriptionNew PassedsuiteFeature 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.
-
every active feature has specs that carry its tagNew PassedsuiteFeature 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. -
planned features name a milestone and excluded features give a reasonNew PassedsuiteFeature registryAdded 2026-10-22, modified 2026-10-23
Checks that planned features name a milestone and excluded features give a reason.
-
every spec belongs to a featureNew PassedsuiteFeature registryAdded 2026-10-22, modified 2026-10-23
Checks that every spec file in features/ is listed under a feature in features.yml.
-
every manifest asset is pinned, licensed and used by a spec or helperNew PassedsuiteFeature 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.
-
every test has a description and a scope tagNew PassedsuiteFeature 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. -
every test has valid added and modified datesNew PassedsuiteFeature registryAdded 2026-10-28
Lists the whole suite and checks that every test has an
addeddate (about(..., { added, modified })), that the dates are YYYY-MM-DD and not in the future, and thatmodifiedis afteradded. Imported JUnit results are exempt: their dates come from git. The report counts new and modified tests per release from these dates. -
the report overview lists each feature's tests, linked to their proceduresNew PassedsuitenominalTest 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.
-
the overview summary counts each feature's tests, and those new or modified since the last releaseNew PassedsuitenominalTest 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.
-
the procedures page shows each test's history and image previewsNew PassedsuitenominalTest 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.
-
a known failure is reported as a known issue, not a failureNew PassedsuitenominalTest 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.
-
known failures sharing a ticket each show their own reasonNew Passedsuiteoff-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.
-
a known failure that passes is reported as passed unexpectedlyNew Passedsuiteoff-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.
-
the report prints to one PDFNew PassedsuitenominalTest report and site pagesAdded 2026-11-03
Runs the three sample tests, then
scripts/report-pdf.mjson 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). -
the PDF script refuses a folder without a reportNew Passedsuiteoff-nominalTest report and site pagesAdded 2026-11-03
Runs
scripts/report-pdf.mjson an empty folder (no test run yet). Passes when it exits non-zero, says the folder has no index.html, and writes no PDF. -
the site lists each capability's tests, linked to their proceduresNew PassedsuitenominalTest 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.
-
the site labels known issues and unexpected passesNew Passedsuiteoff-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.
-
the site builds without test resultsNew Passedsuiteoff-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.















































