CARIS HIPS and SIPS : Support Files Guide : Raster Difference Files
 

Raster Difference Files

Additions or deletions to raster charts can be exported as TIFF images. These images are called difference layers and can serve as a record of the chart’s development from one iteration to the next.

Difference layers are generated from the Raster > Export Difference Layers command in Paper Chart Editor. When this command is run, two TIFF files are created – one showing additions to the raster chart and another showing deletions.

The content and properties of the TIFF files are determined by Raster Difference Rule file. This is an XML file with the extension .rasdiff. The file controls the following properties of raster difference TIFF files:

• type of export

• layers to export

• filename

• colours used for highlighting new or removed material

This is an example of a raster difference file for exporting a raster set.

<?xml version="1.0" encoding="UTF-8"?>

<CARIS_RASTER_DIFFERENCING version="1.0">

  <configuration type="TwoFilesPerRasterSet" addition_suffix="NEW" deletion_suffix="DEL"/>

  <layer name="BUFF" addition_colour="RGB(255,165,0)" deletion_colour="RGB(0,255,0)"/>

  <layer name="BATY" addition_colour="RGB(255,0,0)" deletion_colour="RGB(255,165,0)"/>

  <layer name="AIDS" addition_colour="RGB(255,192,203)" deletion_colour="RGB(173,216,230)"/>

  <layer name="BLPN" addition_colour="RGB(173,216,230)" deletion_colour="RGB(144,238,144)"/>

</CARIS_RASTER_DIFFERENCING>

This is an example of a raster difference file for exporting individual layers.

<?xml version="1.0" encoding="UTF-8"?>

<CARIS_RASTER_DIFFERENCING version="1.0">

<configuration type="TwoFilesPerRasterLayer" addition_suffix="NEW" deletion_suffix="DEL"/>

  <layer name="CONT"/>

  <layer name="MAG"/>

  <layer name="BLPN"/>

</CARIS_RASTER_DIFFERENCING>

No raster difference files are included in the installation. You must create your own. Raster difference files can be saved at any location on a computer or network.

Structure

Tag

Attributes

<CARIS_RASTER_DIFFERENCING />

version="1.0"

<configuration />

type="TwoFilesPerRasterSet" or type="TwoFilesPerRasterLayer"

The TwoFilesPerRasterSet option exports a raster set. Two TIFF files are created. One file shows the raster set with highlighted deletions. The other shows the raster set with highlighted additions.

The TwoFilesPerRasterLayer option exports only additions or deletions in layers that are listed in raster differences rule file. Two TIFF files are created. One files shows deletions in a layer and the other shows only additions.

addition_suffix="NEW"

The string that is appended to the end of the TIFF filename for additions.

The filename is determined by this attribute and the prefix in the Export Difference Layers dialog box. For example, the prefix is "MyLocation" and the suffix is as above, the exported TIFF file is named:

MyLocation_NEW.tif for a raster set or MyLocation_BLPN_NEW.tif for a layer.

deletion_suffix="DEL"

The string that is appended to the end of the TIFF filename for deletions.

The filename is determined by this attribute and the prefix in the Export Difference Layers dialog box. For example, the prefix is "MyLocation" and deletion suffix is the as above, the exported TIFF file is named:

MyLocation_DEL.tif for a raster set or MyLocation_BLPN_DEL.tif for a layer.

<layer />

name="BUFF"

Name of the layer. If exporting a raster set, this attribute defines the layers with highlighted additions and deletions otherwise this attribute defines the layer for export.

addition_colour="RGB(255,165,0)"

The RGB value to highlight additions. This attribute is applied if exporting a raster set.

deletion_colour="RGB(255,165,0)"

The RGB value to highlight deletions. This attribute is applied if exporting a raster set.