VICARIO feature tests

Tier: full · 2026-11-20 21:46 UTC · Duration 152 s · Commit 39ba569 · Workflow run

Result: Passed 270 passed, 0 unexpected failures. Test procedures: what every test does and checks. Full Playwright report: commands, logs and images.

Summary

New and modified count the tests added or changed since release v2.7.2 (published 2026-10-01), from each test's added and modified dates. Known issues are tests of tracked bugs, marked "expected to fail".

Features

FeatureStatus
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
TestScopeResultChange
byte: BSQ, BIL and BIP decode to the same pixelsnominalPassedNew
byte/bsq: VICAR to VICAR round trip keeps type and pixelsnominal losslessPassedNew
byte/bil: VICAR to VICAR round trip keeps type and pixelsnominal losslessPassedNew
byte/bip: VICAR to VICAR round trip keeps type and pixelsnominal losslessPassedNew
half: BSQ, BIL and BIP decode to the same pixelsnominalPassedNew
half/bsq: VICAR to VICAR round trip keeps type and pixelsnominal losslessPassedNew
half/bil: VICAR to VICAR round trip keeps type and pixelsnominal losslessPassedNew
half/bip: VICAR to VICAR round trip keeps type and pixelsnominal losslessPassedNew
full: BSQ, BIL and BIP decode to the same pixelsnominalPassedNew
full/bsq: VICAR to VICAR round trip keeps type and pixelsnominal losslessPassedNew
full/bil: VICAR to VICAR round trip keeps type and pixelsnominal losslessPassedNew
full/bip: VICAR to VICAR round trip keeps type and pixelsnominal losslessPassedNew
real: BSQ, BIL and BIP decode to the same pixelsnominalPassedNew
real/bsq: VICAR to VICAR round trip keeps type and pixelsnominal losslessPassedNew
real/bil: VICAR to VICAR round trip keeps type and pixelsnominal losslessPassedNew
real/bip: VICAR to VICAR round trip keeps type and pixelsnominal losslessPassedNew
doub: BSQ, BIL and BIP decode to the same pixelsnominalPassedNew
doub/bsq: VICAR to VICAR round trip keeps type and pixelsnominal losslessPassedNew
doub/bil: VICAR to VICAR round trip keeps type and pixelsnominal losslessPassedNew
doub/bip: VICAR to VICAR round trip keeps type and pixelsnominal losslessPassedNew
degenerate shape gen_byte_ns1_nl1024.vic survives VICAR and PDS round tripslegacy off-nominal losslessPassedNew
degenerate shape gen_byte_ns1024_nl1.vic survives VICAR and PDS round tripslegacy off-nominal losslessPassedNew
degenerate shape gen_real_100x100.vic survives VICAR and PDS round tripslegacy off-nominal losslessPassedNew
jConvertIIO decodes little-endian int16 (INTFMT/REALFMT LOW)nominalPassedNew
jConvertIIO decodes little-endian float32-bsq (INTFMT/REALFMT LOW)nominalPassedNew
little-endian float32 BSQ, BIL and BIP agree after conversionnominalPassedNew
ImageIO API decodes little-endian HALF the same as BYTE 1..24nominal regressionPassedNew
ImageIO API decodes little-endian int16 the same on every input streamnominal regressionPassedNew
ImageIO API decodes little-endian int32 the same on every input streamnominal regressionPassedNew
ImageIO API decodes little-endian float32-bsq the same on every input streamnominal regressionPassedNew
ImageIO API decodes little-endian float64 the same on every input streamnominal regressionPassedNew
reads bigendian-int16 (system label with DAT_TIM/BINC)malformed-input regressionPassedNew
reads bigendian-float32 (system label with DAT_TIM/BINC)malformed-input regressionPassedNew
reads vax-float32 (system label with DAT_TIM/BINC)malformed-input regressionPassedNew
big-endian and VAX float32 fixtures decode to the same valuesmalformed-input regressionPassedNew
jConvertIIO decodes little-endian DOUB (float64) and FULL (int32) fixturesnominalPassedNew
binary line prefix fixture decodes to its 1x1 imagenominalPassedNew
truncated VICAR file fails with a non-zero exitmalformed-input regressionPassedNew
malformedLabelFailsWithIIOExceptionForWidthunitPassedNew
malformedLabelFailsWithIIOExceptionunitPassedNew
littleEndianFileOnBigEndianStreamunitPassedNew
littleEndianThroughImageioExtStreamunitPassedNew
directPathOnlyForStreamsThatHonourByteOrderunitPassedNew
bigEndianThroughImageioExtStreamunitPassedNew
littleEndianThroughJdkStreamunitPassedNew
programmaticAddStillRejectsUserInPropertyLabelunitPassedNew
readMovesUserOutOfPropertySetunitPassedNew
testunitPassed
programmaticAddStillRejectsDatTimInSystemLabelunitPassedNew
readKeepsOrphanedHistoryItemsInUnknownTaskunitPassedNew
class is listed under a feature in features.ymlsuitePassedNew
class is listed under a feature in features.ymlsuitePassedNew
class is listed under a feature in features.ymlsuitePassedModified

Detailed procedures

Passing
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

Detailed procedures

Passing
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
TestScopeResultChange
VICAR to PDS3 writes a valid label and keeps pixelsnominal losslessPassedNew
EMBED_VICAR_LABEL=true embeds the VICAR labelnominal losslessPassedNew
PDS_FILENAME_IN_LABEL=true puts the output file name in the labelnominal regression losslessPassedNew
PDS_FILENAME (older spelling) still puts the file name in the labelnominal regressionPassedNew
without PDS_FILENAME_IN_LABEL, or with =false, the label names no fileoff-nominal regressionPassedNew
PDS_LABEL_TYPE=ODL3 writes an ODL3 labelnominalPassedNew
reads an MSL Navcam EDR thumbnail (attached PDS3 + VICAR labels)mission-data losslessPassedNew
reads an MSL Navcam EDR through its detached .LBLmission-data regression losslessPassedNew
namespaced PDS3 keywords (MSL:...) become legal VICAR keywordsmission-data regressionPassedNew
PDS-labelled input to FORMAT=pds with the default stylesheetmission-data regressionPassedNew
PDS-labelled input to FORMAT=pds with an explicit copy stylesheetmission-data losslessPassedNew
MSL Navcam full EDR reads and round-trips through VICARmission-data losslessPassedNew
MER Opportunity Navcam EDR reads (stand-in for the legacy mer_file.vic)mission-data legacyPassedNew
Cassini ISS: VICAR image and its detached PDS3 label decode identicallymission-dataPassedNew
fileChannelStreamSeekPastEndReadsEofunitPassedNew
headerPointerAtStartOfDataFileKeepsVicarLabelunitPassedNew
headerPointerPastEndOfLabelFileunitPassedNew
noImageObjectProducesEmptySystemLabelunitPassed
readsRflImageWithExplicitParamunitPassed
readsRflImageViaHeuristicWhenParamUnsetunitPassed
readsStandardImageObjectunitPassed
class is listed under a feature in features.ymlsuitePassedNew
class is listed under a feature in features.ymlsuitePassed

Detailed procedures

Passing
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
TestScopeResultChange
XSL=- uses the default stylesheet from the jarnominal losslessPassedNew
legacy recipe: XML=false, VicarToPDSmer1.xsl, EMBED_VICAR_LABEL=truelegacy nominalPassedNew
all 23 bundled VicarToPDS stylesheets produce valid labelsnominal losslessPassedNew
legacy normal.pds recipe on a public MER EDR (via VICAR)legacy mission-data losslessPassedNew
VICAR-to-PDS stylesheet on a PDS-labelled MER EDRlegacy mission-data off-nominal regressionPassedNew

Detailed procedures

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

Detailed procedures

Passing
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

Detailed procedures

Passing, with known issues
ISIS cubes
Reading ISIS2 cubes with SFDU labels, such as Cassini VIMS spectral cubes (ISIS3 cubes are not supported).
7 tests

Detailed procedures

Passing
FITS images
Reading FITS images and converting them to other formats.
1 test
TestScopeResultChange
reads HorseHead.fits and converts it to VICAR and TIFFmission-data losslessPassedNew

Detailed procedures

Passing
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
TestScopeResultChange
F-BIDR reader decodes the orbit 378 image stripmission-data regressionPassedNew
jConvertIIO converts the F-BIDR to VICARmission-data regression losslessPassedNew

Detailed procedures

Passing
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
TestScopeResultChange
FORMAT=tif (#01)legacy losslessPassedNew
FORMAT=tiff (#02)legacy losslessPassedNew
FORMAT=TIF (#03)legacy losslessPassedNew
FORMAT=TIFF (#04)legacy losslessPassedNew
FORMAT=png (#05)legacy losslessPassedNew
FORMAT=PNG (#06)legacy losslessPassedNew
FORMAT=jpeg2000 (#07)legacy losslessPassedNew
FORMAT=JPEG2000 (#08)legacy losslessPassedNew
FORMAT=JPEG 2000 (#09)legacy losslessPassedNew
FORMAT=jpeg 2000 (#10)legacy losslessPassedNew
FORMAT=pds (#11)legacy losslessPassedNew
FORMAT=vicar (#12)legacy losslessPassedNew
FORMAT=jpg (#13)legacy nominalPassedNew
FORMAT=JPG (#14)legacy nominalPassedNew
FORMAT=jpeg (#15)legacy nominalPassedNew
FORMAT=JPEG (#16)legacy nominalPassedNew
FORMAT=raw (#17)legacy nominal lossless regressionPassedNew
FORMAT=RAW (#18)legacy nominal lossless regressionPassedNew
FORMAT=bmp (#19)legacy lossless regressionPassedNew
FORMAT=BMP (#20)legacy lossless regressionPassedNew
FORMAT=pnm (#21)legacy nominal lossless regressionPassedNew
FORMAT=PNM (#22)legacy nominal lossless regressionPassedNew
FORMAT=jfif (#23)legacy nominalPassedNew
FORMAT=JFIF (#24)legacy nominalPassedNew
FORMAT=jpeg-ls (#25)legacy off-nominalKnown issueNew
FORMAT=JPEG-LS (#26)legacy off-nominalKnown issueNew
FORMAT=jpeg-lossless (#27)legacy off-nominalKnown issueNew
FORMAT=JPEG-LOSSLESS (#28)legacy off-nominalKnown issueNew
FORMAT=isis (#29)legacy off-nominalKnown issueNew
RAW output of gen_byte_bil.vic is exactly its samples, band sequentialnominal lossless regressionPassedNew
RAW output of gen_byte_bip.vic is exactly its samples, band sequentialnominal lossless regressionPassedNew
RAW output of gen_byte_gray.vic is exactly its samples, band sequentialnominal lossless regressionPassedNew
RAW output of gen_half_bsq.vic is exactly its samples, band sequentialnominal lossless regressionPassedNew
RAW output of gen_real_100x100.vic is exactly its samples, band sequentialoff-nominal lossless regressionPassedNew
RAW output of gen_byte_ns1_nl1024.vic is exactly its samples, band sequentialoff-nominal lossless regressionPassedNew
BMP output of a band-interleaved-by-line (BIL) image keeps its pixelsnominal lossless regressionPassedNew
HALF input to BMP without OFORM is refused with a non-zero exitoff-nominalPassedNew
a writer that crashes fails the conversion cleanlyoff-nominal regressionPassedNew
PNM output of gen_byte_gray.vic keeps its pixelsnominal lossless regressionPassedNew
PNM output of gen_half_bsq.vic keeps its pixelsnominal lossless regressionPassedNew
PNM output of gen_real_bsq.vic is refused with a messageoff-nominalPassedNew
PNM output of gen_byte_rgba.vic is refused with a messageoff-nominalPassedNew
a PNM file written by jConvertIIO can be read back as inputoff-nominalKnown issueNew
a TIFF file written by jConvertIIO can be read back as inputnominal lossless regressionPassedNew
HALF input to FORMAT=tif is losslessnominal losslessPassedNew
HALF input to FORMAT=png is losslessnominal losslessPassedNew
HALF input to FORMAT=jpeg2000 is losslessnominal losslessPassedNew
HALF input to FORMAT=pds is losslessnominal losslessPassedNew
HALF input to FORMAT=vicar is losslessnominal losslessPassedNew
REAL input to FORMAT=tif is losslessnominal losslessPassedNew
REAL input to FORMAT=pds is losslessnominal losslessPassedNew
REAL input to FORMAT=vicar is losslessnominal losslessPassedNew
a FORMAT with no registered writer is refused with a messageoff-nominalPassedNew
REAL input to PNG without OFORM is refused with a non-zero exitoff-nominalPassedNew
HALF input to JPEG without OFORM is refused with a non-zero exitoff-nominal regressionPassedNew
preferOverRemovesTheJaiImageioWriterunitPassedNew
writesEightBitGrayAsP5unitPassedNew
writesSixteenBitRgbAsBigEndianP6unitPassedNew
refusesFourBandsunitPassedNew
class is listed under a feature in features.ymlsuitePassedNew

Detailed procedures

Passing, with known issues
Data type conversion
Changing the output data type (OFORM) with or without rescaling, clamping, and float data to 8-bit display formats.
14 tests

Detailed procedures

Passing
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

Detailed procedures

Passing
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

Detailed procedures

Passing
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
TestScopeResultChange
ARGFILE batch runs every linenominal losslessPassedNew
ARGFILE batch with PARALLEL_BATCH=2 runs every linenominal losslessPassedNew
input and output file names without extensionsoff-nominal regression losslessPassedNew
OUT=- with SILENT writes the image to stdoutnominal regression losslessPassedNew
OUT=- without SILENT keeps messages off stdoutnominal regression losslessPassedNew
FORMAT without OUT, and OUT=- without FORMAT, are refusedoff-nominal regressionPassedNew
OUT=- on an ARGFILE line is refusedoff-nominal regressionPassedNew
OUT=- on an ARGFILE line is refused (PARALLEL_BATCH=2)off-nominal regressionPassedNew
https input from the public PDS archive matches the local copymission-data losslessPassedNew

Detailed procedures

Passing
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
TestScopeResultChange
legacy step 18: PNG converted to JPEG displayslegacy nominalPassedNew
browse image of msl-navcam-thumb-img displaysmission-data legacyPassedNew
browse image of m2020-navcam-thumb-img displaysmission-data legacyPassedNew
browse image of cassini-iss-img displaysmission-data legacyPassedNew
browse image of astropy-horsehead-fits displaysmission-data legacyPassedNew
browse image of mer1-navcam-edr displaysmission-data legacyPassedNew
browse image of msl-navcam-edr-img displaysmission-data legacyPassedNew
browse image of m2020-navcam-edr-img displaysmission-data legacyPassedNew

Detailed procedures

Passing
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

Detailed procedures

Passing
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

Detailed procedures

Passing
Test suite integrity
Feature registry, specs and test-data manifest are consistent.
18 tests

Detailed procedures

Passing

Known issues

Bugs reproduced by the tests and tracked by issue. Each test is marked "expected to fail" and turns red once the bug is fixed, so the marker is removed with the fix.

IDS-10429 7 tests
  • Output formats: Output formats › FORMAT=jpeg-ls (#25)
    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
  • Output formats: Output formats › FORMAT=JPEG-LS (#26)
    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
  • Output formats: Output formats › FORMAT=jpeg-lossless (#27)
    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
  • Output formats: Output formats › FORMAT=JPEG-LOSSLESS (#28)
    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
  • Output formats: Output formats › FORMAT=isis (#29)
    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
  • Output formats: Output formats › a PNM file written by jConvertIIO can be read back as input
    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
  • PDS4 tables: PDS4 tables › delimited (CSV) table
    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)

Click a feature to see its tests in the full Playwright report, with commands, logs and image previews for every conversion. Open its test list for a summary of each test, linked to its detailed procedure.