Registration Transformation File Format

This page details the format, in Backus -Naur Form (BNF) notation, when the transformation required to register an image to another is written to file. This is intended for those who wish to build their own syntactically correct parser to interpret the contents of these files. See the BNF section for a description of the notation.

A Registration Transformation Parameters file (<rtp-spec>) is a plain text file, consisting of a header (<rtp-header-spec>) followed by the transformation parameters (<rtp-params-spec>). In the Registration Transform Parameters file, white space is used to separate the elements within an entry. White space may consist of space characters, tab characters or new-line characters. The amount of white space is not significant. Individual elements that may contain white space are enclosed in double quotes ("). Literal string elements are shown in non-italic font below.

`<rtp-spec> ::=`	`<rtp-header-spec><rtp-params-spec>`
`<rtp-header-spec> ::=`	`# Transform written on <date-time-spec> by Operator ID=<string-spec> # Vendor="Xinapse_Systems_Limited" # Build version=<version-spec> # Base image=<string-spec> # Image source=<string-spec>`
`<rtp-params-spec> ::=`	`AffineTransform=[[<num-spec>][<num-spec>][<num-spec>][<num-spec>]] [[<num-spec>][<num-spec>][<num-spec>][<num-spec>]] [[<num-spec>][<num-spec>][<num-spec>][<num-spec>]]`
`<date-time-spec> ::=`	`"dd mmm yyyy hh:mm:ss.SSS zzzz"`

<version-spec> is a string of ASCII text characters enclosed in double quotation marks (") giving the build version of Jim. The build version is of the form "MajorVersion_MinorVersion", e.g., "8.0_1"

<string-spec> is a string of ASCII text characters enclosed in double quotation marks (").
<num-spec> is a numerical value in floating point format.

The 12 numbers that compose the <rtp-params-spec> are the values of the Affine Transform, in the following order: m₀₀, m₀₁, m₀₂, m₀₃, m₁₀, m₁₁, m₁₂, m₁₃, m₂₀, m₂₁, m₂₂, m₂₃, and the Affine transformation matrix is

      | m00  m01  m02  m03 |       
      | m10  m11  m12  m13 |       
      | m20  m21  m22  m23 |       
      |  0    0    0    1  |

An example of the format of a .rtp file written to disk is shown below:

      
# Transform written on "16 Dec 2013 16:50:05.895 GMT+00:00" by Operator ID "xinapse"
# Vendor="Xinapse_Systems_Limited"
# Build version="8.0_1"
# Base image="/home/xinapse/3D"
# Image source="/home/xinapse/3Da"
AffineTransform=[[0.9999662][0.008222148][0.0][-2.2419496]][[-0.008217804][0.999438][0.032498352][0.80597603]][[2.6720623E-4][-0.032497253][0.9994718][-3.2087297]]

Jim Home