Json schema for the FA4.0 standardized Header

Type: object

This schema defines the Standardized JSON Header used for the meta data collection within the FA4.0 project. It defines each section as well es the properties of the General section, Method and Customer specific section as well as the Data Evaluation section where metadata of a measurement should be mapped to. The General Section is thereby identical for all tools. Meta data which represent a physical quantity are declared as objects and contain a 'Value' and 'Unit' as properties in the JSON header.

Type: object

The general section incorporates general informational data about the measurement as well as the properties which are supported by every used tool. The section is thereby identically defined for all standard header.

The following properties are required:

  • Previous Header File

Type: string

The path to the generated file, linked to the json file.

Type: string

The Name of the generated file, linked to the json file.

Type: string

Indicates the file format.

Type: object

The file size in [bytes]

Type: integer or null

Type: string

Type: string

The path to the created log file of the tool. Is left ommitted if there is no existing logfile.

Type: string

Used standard for creation of header file

Type: object

The version of the standard header type.

Type: stringFormat: date-time

The time stamp, when the file was generated in ISO8601 format (YYYY-MM-DD hh:mm:ss). An add on indicates the differences to the Coordinated Universal Time (UTC), for example +01:00 for Central European Time (CET)

Type: string

The manufacturer name of the measurement tool.

Type: string

The name of the measurement tool.

Type: string

The value is the unique manufacturer serial number of a measurement tool.

Type: string

Indicates the analysis method.

Type: object

The width of the image in pixel.

Type: integer or null

Type: string

Type: object

The height of the image in pixel.

Type: integer or null

Type: string

Type: object

The width of each pixel. The unit is specified under the property 'Unit' and should preferable be chosen in [nm].

Type: number or null

Type: string

Type: object

The height of each pixel. The unit is specified under the property 'Unit' and should preferable be chosen in [nm].

Type: number or null

Type: string

Type: integer or null

The number of bits each pixel can resolute. For example a 8-bit depth in a grayscale image, means a resolution of 256 grayscales.

Type: number or null

The amount of compressed bits per pixel.

Type: string

The color mode of the image

Type: string

The name of the respective company which performed the measurement.

Type: string

The name of the used sample holder.

Type: boolean

This key indicates if the tool is correctly calibrated. Value is 'true' for correctly calibrated.

Type: object

The Coordinate Sub Section defines the coordinate handling in the json files. The screen coordinates are defined to be a right handed coordinate system with its origin on the top left of the screen. The x-coordinate increases to the right; y-coordinates are incremented from top to bottom. Having an image file, the saved tool coordinates for this file are defined to be in the center of the image. The properties can be used to transform the stage coordinates into screen coordinates, when analysing an image.

Type: enum (of string)

Indicates whether the tool's cartesian coordinate system is right or left handed.

Must be one of:

  • "right handed"
  • "left handed"

Type: boolean

This value indicates whether chained movements of the tool's stage are defined around a global fixed frame or around its local frame. True indicates that the stage moves around a global frame and false that it moves around its local frame.

Type: object

This array describes the relative offset orientation of the tool's global frame to the screens coordinate frame. The first entry denotes the angle around the X-axis, the second around the Y-axis and the third around the Z-axis in degrees. The angles are relative to the tools global frame.

Type: object

The three translational coordinates X, Y and Z of the tool's stage relative to the tool's global coordinate frame. The first entry denotes the X-coordinate and last denotes the Z-coordinate.

Type: array
No Additional Items

Each item of this array must be:

Type: object or null

Rx is the vertical angle which describes the rotation of the tool's stage around a horizontal axis parallel to the x-axis of either the tool's global or local frame. The unit is specified under the property 'Unit' and should preferable be chosen in [degrees].

Type: object or null

Ry is the vertical angle which describes the rotation of the tool's stage around a horizontal axis parallel to the y-axis of either the tool's global or local frame. The unit is specified under the property 'Unit' and should preferable be chosen in [degrees].

Type: object or null

Rz is the horizontal angle which describes the rotation of the tool's stage around a vertical axis parallel to the z-axis of either the tool's global or local frame. The unit is specified under the property 'Unit' and should preferable be chosen in [degrees].

Type: object

This subsection is reserved for parameter of the alignment marks of the universal sample holder

Type: object

The offset vector for the calculation of the transformation matrix in the order of (X,Y,Z).

Type: array
No Additional Items

Each item of this array must be:

Type: object

The coordinates of the 3 Alignment Marks relative to the tool's global coordinate frame.

Type: object

Position of Alignment Mark1 in the order of (X,Y,Z).

Type: object

Position of Alignment Mark2 in the order of (X,Y,Z).

Type: object

Position of Alignment Mark3 in the order of (X,Y,Z).

Type: string

Shape of the Alignment Marks.

Type: object

Describes a size property of the fiducial. Example: the diameter for circles. The unit is specified under the property 'Unit' and should preferable be chosen in [µm].

Type: object

The method specific section incorporates the all neccessary metadata for each measurement methods.

Type: object

The Scanning Electron Microscopy subsection describes all specific SEM-metadata which are adjustable in each SEM device.

Type: string

Indicates the previously applied supplementary method, e.g. sample preparation. Is left empty if no supplementary method is indicated.

Type: object

The Accelerating Voltage describes the voltage at the cathode which generates the electric accelerating field. The unit is specified under the property 'Unit' and should preferable be chosen in [kV].

Type: object

The Deccelerating Voltage describes a negative voltage which can be applied at the tool's stage, to deccelerate the beam before it hits the specimen for a lower landing voltage. The unit is specified under the property 'Unit' and should preferable be chosen in [kV].

Type: object

The working distance, is defined as the distance between the objective lens and the focal plane or the final crossover point of the beam. The unit is specified under the property 'Unit' and should preferable be chosen in [mm].

Type: string

The Magnification value indicates the magnification of the raster field.

Type: boolean

Indicates if more Signals were mixed to generate the image. Equals true if Signal Mixing Mode is used.

Type: array of string

The type(s) of signal used to generate the image.

No Additional Items

Each item of this array must be:

Type: array of string

The type of detector(s) used by the tool to collect the electron signal.

No Additional Items

Each item of this array must be:

Type: array or null

Describes the proportion of the used signal(s). The values are in the range of [0.0, 1.0].

No Additional Items

Each item of this array must be:

Type: object

The size of the used aperture diameter. The unit is specified under the property 'Unit' and should preferable be chosen in [µm].

Type: array

The relative centering of the aperture in x and y direction in the electron beam path. The first entry denotes the x-proportion and the second the y-proportion in the range of [-1.0, 1.0].

No Additional Items

Each item of this array must be:

Type: array

The relative alignment of the magnetic field in the objective lens to form or shift the elctronic beam in X and Y direction. The first entry denotes the x-proportion and the second the y-proportion in the range of [-1.0, 1.0].

No Additional Items

Each item of this array must be:

Type: array or null

The relative brightness of the image in the range of [0.0, 1.0]. A value of 1.0 corresponds to a white image and 0.0 to a black image. Brightness is an array, since for some devices the brightness can be ajdusted for each used detector which generated the image in a mixing mode.

No Additional Items

Each item of this array must be:

Type: array or null

The relative contrast of the image in the range of [0.0, 1.0]. Higher values correspond to a high contrast. Constrast is an array, since for some devices the constrast can be ajdusted for each used detector which generated the image in a mixing mode.

No Additional Items

Each item of this array must be:

Type: object

The value indicates the emitted current out of the electron gun. The unit is specified under the property 'Unit' and should preferable be chosen in [µA].

Type: object

The value indicates the current which hits the specimen. The unit is specified under the property 'Unit' and should preferable be chosen in [pA].

Type: boolean or null

Indicates if the high current mode is used. Equals true if high current mode is used

Type: boolean or null

Indicates if the tilt correction mode is used to equalize the image. Equals true if the tilt correction mode is used

Type: object

The corrected tilt value by tilt correction mode. The unit is specified under the property 'Unit' and should preferable be chosen in [degrees].

Type: object

Shift of the electron beam in x-direction. The unit is specified under the property 'Unit' and should preferable be chosen in [µm].

Type: object

Shift of the electron beam in y-direction. The unit is specified under the property 'Unit' and should preferable be chosen in [µm].

Type: boolean or null

Indicates if the scan rotation mode is used to rotate the image. Equals true if scan rotation mode is used

Type: object

The value indicates the angle of the scan direction relative to the tools global frame. The unit is specified under the property 'Unit' and should preferable be chosen in [degrees].

Type: object

The Focused Ion Beam subsection describes all specific FIB-metadata which are adjustable in each FIB device.

Type: object

Indicates the working distance where the electron and ion beam intersect for dual beam devices (equal to FIB-SEM coincedence point). The unit is specified under the property 'Unit' and should preferable be chosen in [mm].

Type: object

Indicates the tilt value of the stage, where the stage is perpendicular to the FIB column. The unit is specified under the property 'Unit' and should preferable be chosen in [degrees].

Type: object

The Accelerating Voltage describes the voltage at the cathode which generates the electric accelerating field. The unit is specified under the property 'Unit' and should preferable be chosen in [kV].

Type: object

The Deccelerating Voltage describes a negative voltage which can be applied at the tool's stage, to deccelerate the beam before it hits the specimen for a lower landing voltage. The unit is specified under the property 'Unit' and should preferable be chosen in [kV].

Type: object

The working distance, is defined as the distance between the objective lens and the focal plane or the final crossover point of the beam. The unit is specified under the property 'Unit' and should preferable be chosen in [mm].

Type: string

The Magnification value indicates the magnification of the raster field.

Type: boolean

Indicates if more Signals were mixed to generate the image. Equals true if Signal Mixing Mode is used.

Type: array of string

The type(s) of signal used to generate the image.

No Additional Items

Each item of this array must be:

Type: array of string

The type of detector(s) used by the tool to collect the electron signal.

No Additional Items

Each item of this array must be:

Type: array

Describes the proportion of the used signal(s). The values are in the range of [0.0, 1.0].

No Additional Items

Each item of this array must be:

Type: object

The size of the used aperture diameter. The unit is specified under the property 'Unit' and should preferable be chosen in [µm].

Type: array

The relative centering of the aperture in x and y direction in the electron beam path. The first entry denotes the x-proportion and the second the y-proportion in the range of [-1.0, 1.0].

No Additional Items

Each item of this array must be:

Type: array

The relative alignment of the magnetic field in the objective lens to form or shift the elctronic beam in X and Y direction. The first entry denotes the x-proportion and the second the y-proportion in the range of [-1.0, 1.0].

No Additional Items

Each item of this array must be:

Type: array or null

The relative brightness of the image in the range of [0.0, 1.0]. A value of 1.0 corresponds to a white image and 0.0 to a black image. Brightness is an array, since for some devices the brightness can be ajdusted for each used detector which generated the image in a mixing mode.

No Additional Items

Each item of this array must be:

Type: array or null

The relative contrast of the image in the range of [0.0, 1.0]. Higher values correspond to a high contrast. Constrast is an array, since for some devices the constrast can be ajdusted for each used detector which generated the image in a mixing mode.

No Additional Items

Each item of this array must be:

Type: object

The value indicates the emitted current out of the ion gun. The unit is specified under the property 'Unit' and should preferable be chosen in [µA].

Type: object

The value indicates the current which hits the specimen. The unit is specified under the property 'Unit' and should preferable be chosen in [pA].

Type: boolean or null

Indicates if the high current mode is used. Equals true if high current mode is used

Type: boolean or null

Indicates if the tilt correction mode is used to equalize the image. Equals true if the tilt correction mode is used

Type: object

The corrected tilt value by tilt correction mode. The unit is specified under the property 'Unit' and should preferable be chosen in [degrees].

Type: object

Shift of the electron beam in x-direction. The unit is specified under the property 'Unit' and should preferable be chosen in [µm].

Type: object

Shift of the electron beam in y-direction. The unit is specified under the property 'Unit' and should preferable be chosen in [µm].

Type: boolean

Indicates if the scan rotation mode is used to rotate the image. Equals true if scan rotation mode is used

Type: object

The value indicates the angle of the scan direction relative to the tools global frame. The unit is specified under the property 'Unit' and should preferable be chosen in [degrees].

Type: object

The Optical Microscopy subsection describes all specific metadata which are common in each Optical Microscopy device.

Type: number or null

The objective Lens Magnification determines the factor by which the object is magnified by the obcetive lens relative to its actual size.

Type: number or null

The Optical Zoom is the magnification factor created in the tube of the objective.

Type: number or null

The Digital Zoom value is the factor by which the image is digitally magnified, by cropping and resizing the original image.

Type: string

Specifies with which method the sample has been illuminated, to create the image.

Type: boolean or null

Indicates if the HDR (High Dynamic Range) Mode is used. Is true if HDR Mode was on.

Type: object

The exposure time determines the duration that the detector of the microscope is exposed to the reflected light. The value is preferable given in [ms].

Type: object or null

The tool specific section contains the metadata which are specific for a tool.

Type: object or null

The Tescan XEIA3 sub section contains the metadata which is specific for the Tescan XEIA3 and not listed in the standard method specific section.

Type: object or null

The ZEISS GeminiSEM 500 sub section contains the metadata which is specific for the ZEISS GeminiSEM 500 and not listed in the standard method specific section.

Type: object or null

ZEISS LEO Gemini 1550 sub section contains the metadata which is specific for the ZEISS LEO Gemini 1550 and not listed in the standard method specific section.

Type: object or null

ZEISS LEO Gemini 1560 sub section contains the metadata which is specific for the ZEISS LEO Gemini 1560 and not listed in the standard method specific section.

Type: object or null

The ZEISS Gemini ULTRA 55 sub section contains the metadata which is specific for the ZEISS Gemini ULTRA 55 and not listed in the standard method specific section.

Type: object or null

The ZEISS Gemini SUPRA 55 sub section contains the metadata which is specific for the ZEISS Gemini SUPRA 55 and not listed in the standard method specific section.

Type: object or null

The HITACHI SU8000 sub section contains the metadata which is specific for the HITACHI SU8000 and not listed in the standard method specific section.

Type: object or null

The HITACHI SU8200 sub section contains the metadata which is specific for the HITACHI SU8200 and not listed in the standard method specific section.

Type: object or null

The FEI Magellan 400 sub section contains the metadata which is specific for the FEI Magellan 400 and not listed in the standard method specific section.

Type: object or null

The Olympus DSX110 sub section contains the metadata which is specific for the Olympus DSX110 and not listed in the standard method specific section.

Type: object or null

The Olympus DSX500 sub section contains the metadata which is specific for the Olympus DSX500 and not listed in the standard method specific section.

Type: object or null

The Olympus DSX1000 sub section contains the metadata which is specific for the Olympus DSX1000 and not listed in the standard method specific section.

Type: object or null

The customer specific section contains specific meta data defined by a customer.

Type: object or null

The Infineon subsection contains specific metadata defined by the customer Infineon.

Type: object or null

The Data Evaluation section contains metadata about a measurement evaluation.

Type: string

The label to the image. The image label can for example be an image caption or represent a failure mode and takes any string.

Type: string

The unique ID to the image.

Type: array of object or null

.POI (point of interest) is an array which contains all the 0-N POIs selected by the user. One POI is a point on the image, defined by its name and (x, y)-coordinates.

No Additional Items

Each item of this array must be:

Type: object

Type: string

The name of the specific POI which can be any string.

Type: string

The label cathegorizes the selected POI to a certain class. The class should represent a certain failure mode.

Type: string

Unique ID to the labeled POI.

Type: object

(x, y) coordinates of the specific POI in the tools coordinate frame. The first element denotes the x-coordinate and the second the y-coordinate. The unit is specified under the property 'Unit'.

Type: array

Must contain a maximum of 2 items

No Additional Items

Each item of this array must be:

Type: object or null

An ROI is any by the user segmented area in the image. This subsection contains metadata of each type of ROIs which were segmented by the user. It provides information like area of the ROI or coordinate of points that frame the region of the ROI.

Type: array of object

ROI-Polygon is an array which contains all ROI-Polygons selected by the user. A polygon is any drawn plane consisting of vertices selected by the user, which are connected over straight lines to form a closed area. ROI-Polygon contains the name of the polygon, the coordinates of the vertices, the area of the closed polygon, the filling color as well as color and width of the stroke.

No Additional Items

Each item of this array must be:

Type: object

Type: string

The label cathegorizes the segmented ROI-Polygon to a certain class. The class should represent a certain failure mode.

Type: string

Unique ID to the labeled ROI-Polygon.

Type: object

Represents an N x 2 matrix whose rows contain the x and y coordinates in the tools coordinate frame of the vertices which define the polygon. The vertices are connected over straight lines and are rudimentary numbered from the first row (first vertice coordinate of the polygon) to the bottom row which represents the last vertice which is also connected to the first vertice to close the polygon. In the json format the matrix is defined as an array of arrays. The unit is specified under the property 'Unit'.

Type: array of array
No Additional Items

Each item of this array must be:

Type: array

Must contain a maximum of 2 items

No Additional Items

Each item of this array must be:

Type: object

The area of the drawn polygon in the unit of the tools coordinate frame. The unit is specified under the property 'Unit'.

Type: array

The fill color of the polygon encoded in RGBA.

Must contain a minimum of 4 items

Must contain a maximum of 4 items

No Additional Items

Each item of this array must be:

Type: array

The color of the stroke the polygon was drawn with, encoded in RGB.

Must contain a minimum of 3 items

Must contain a maximum of 3 items

No Additional Items

Each item of this array must be:

Type: object

The width of the stroke. The unit is specified under the property 'Unit' and should preferable be chosen in pixels.

Type: array of object

ROI-Polyline is an array which contains all ROI-Polylines selected by the user. A polyline is specified by an array of vertices that are connected over straight lines. The first vertice is the starting point and the last vertice the end point of the polyline (an arrowhed marker is applied to the end of the line). ROI-Polyline contains the name of the polyline, the coordinates of the vertices as well as color and width of the stroke.

No Additional Items

Each item of this array must be:

Type: object

Type: string

The name of the specific polyline which can be any string.

Type: string

The label cathegorizes the segmented polyline to a certain class. The class should represent a certain failure mode.

Type: string

Unique ID to the labeled polyline.

Type: object

Represents an N x 2 matrix whose rows contain the x and y coordinates in the tools coordinate frame of the vertices which define the polyline. The vertices are connected over straight lines and are rudimentary numbered from the first row (start point of the polyline) to the bottom row which represents the endpoint of the line (arrowhead marker is applied to the end of the line). In the json format the matrix is defined as an array of arrays. The unit is specified under the property 'Unit'.

Type: array of array
No Additional Items

Each item of this array must be:

Type: array

Must contain a maximum of 2 items

No Additional Items

Each item of this array must be:

Type: array

The color of the stroke the polyline was drawn with, encoded in RGB.

Must contain a minimum of 3 items

Must contain a maximum of 3 items

No Additional Items

Each item of this array must be:

Type: object

The width of the stroke. The unit is specified under the property 'Unit' and should preferable be chosen in pixels.

Type: object or null

The History section is intended to store data of pevious related measurements or images. Like the link to the previous Header file.