Official websites use .gov
A .gov website belongs to an official government organization in the United States.

Secure .gov websites use HTTPS
A lock ( ) or https:// means you’ve safely connected to the .gov website. Share sensitive information only on official, secure websites.

ISIS Documentation

pvldiff

Compare two pvl files

This program will compare two PVL files with or without a tolerance. The purpose of this program is for application tests, that output a Pvl formatted file, to be able to specify tolerances in numerical values of keywords.

Categories

History

Steven Lambright2007-08-10 Original version
Travis Addair2009-07-31 Added capabilities for unique tolerances and ignore keys for individual array elements within keywords
Christopher Combs2017-06-16 Added capability to ignore file paths for elements of PvlKeywords

Parameters

Files

Type filename
File Mode input
Filter *.pvl *.txt

Type filename
File Mode input
Filter *.pvl *.txt

This is used to specify tolerances between the two input file. If this file is not specified, the two Pvl files must match exactly. See Isis Application and Category Test How-to for information about the tolerance file.
Type filename
File Mode input
Internal Default None
Filter *.pvl *.txt *.pvl.DIFF

This will output the differences to a text file.
Type filename
File Mode output
Internal Default None
Filter *.txt

Example 1

Basic Comparison

This example will cover doing a basic difference between two pvl files and how to interpret the results.

Command Line

Differencing pvl1.pvl and pvl2.pvl
pvldiff from=pvl1.pvl from2=pvl2.pvl

GUI Screenshot

Differencing two files

Running this program with pvl1.pvl and pvl2.pvl

Differencing two files

This shows how to run this program to compare the two pvl files pvl1.pvl and pvl2.pvl.

Data Files

Links open in a new window.
pvl1.pvl This is the file used in the input parameter FROM. It will be compared with pvl2.pvl.
pvl2.pvl This is the file used in the input parameter FROM2. It will be compared with pvl1.pvl.

Output Image

Results

The results from comparing pvl1.pvl and pvl2.pvl

Results

This is the output after running this program on pvl1.pvl and pvl2.pvl. Since the input pvl files differed, it shows the first difference encountered. Notice it also says exactly where the difference was found and, if numerical, the tolerance.

Example 2

Basic Comparison With Tolerance

This example will cover doing a basic difference between two pvl files with a tolerance file.

Command Line

Differencing pvl1.pvl and pvl2.pvl
pvldiff from=pvl1.pvl from2=pvl2.pvl diff=tolerance.pvl

GUI Screenshot

Differencing two files

Running this program with pvl1.pvl and pvl2.pvl with tolerance

Differencing two files

This shows how to run this program to compare the two pvl files pvl1.pvl and pvl2.pvl using a tolerance file.

Data Files

Links open in a new window.
pvl1.pvl This is the file used in the input parameter FROM. It will be compared with pvl2.pvl.
pvl2.pvl This is the file used in the input parameter FROM2. It will be compared with pvl1.pvl.
tolerance.pvl This is the file used in the input parameter DIFF. It specifies the tolerance for the two files.

Output Image

Results

The results from comparing pvl1.pvl and pvl2.pvl

Results

This is the output after running this program on pvl1.pvl and pvl2.pvl. The input pvl files differed, but not more than specified by the tolerance so the results came back identicle.