Specimens¶

The specimens array lists the specimens on which the inspection is performed.

specimens¶

Property	Type	Description
id `required`	integer	Unique specimen id in the JSON structure
One of the following `required` geometry objects: plateGeometry pipeGeometry barGeometry unspecifiedGeometry	object
weldGeometry	object	A weldGeometry object
customOverlay2D	object	A customOverlay2D object

plateGeometry¶

Typeobject

The plateGeometry object describes a generic plate geometry.

Property	Type	Unit	Description
width	number	m	Plate width
length	number	m	Plate length
thickness `required`	number	m	Plate thickness
material	object	-	A material object
surfaces `required`	array	-	A surfaces array

pipeGeometry¶

Typeobject

The pipeGeometry object describes a generic pipe geometry.

Property	Type	Unit	Description
length	number	m	Pipe length
thickness `required`	number	m	Pipe thickness
outerRadius	number	m	Outer radius of the pipe
angularOpening	number	°	Angular opening of the pipe
material	object	-	A material object
surfaces `required`	array	-	A surfaces array

barGeometry¶

Typeobject

The barGeometry object describes a generic bar geometry.

Property	Type	Unit	Description
length `required`	number	m	Bar length
diameter `required`	number	m	Bar diameter
material	object	-	A material object
surfaces `required`	array	-	A surfaces array

unspecifiedGeometry¶

Typeobject

The unspecifiedGeometry object is used when the specimen geometry is not known or not relevant to the acquisition. Only the inspectable surfaces are declared; no dimensions or material are provided.

Property	Type	Description
surfaces `required`	array	A surfaces array

material¶

Typeobject

The material object describes generic material properties.

Property	Type	Unit	Description
name `required`	string	-	Name of the material
longitudinalWave `required`	object	-	A wave object
transversalWave `required`	object	-	A wave object
density	number	kg/m³	Density of the material

wave¶

Typeobject

The wave object describes an ultrasonic wave.

Property	Type	Unit	Description
nominalVelocity `required`	number	m/s	Speed of sound in the material
attenuationCoefficient	number	dB/m/MHz	Attenuation coefficient in the material

surfaces¶

Typearray

The surfaces array lists the inspectable surfaces of the specimen.

Property	Type	Description
id `required`	integer	Unique surface id
name	string	Surface name. Required for `plateGeometry`, `pipeGeometry`, and `barGeometry`; omitted for `unspecifiedGeometry`.

Valid surface names per geometry type:

plateGeometry: Top or Bottom
pipeGeometry: Inside or Outside
barGeometry: Outside
unspecifiedGeometry: not applicable

weldGeometry¶

Typeobject

The weldGeometry object describes a generic weld geometry.

Property	Type	Unit	Description
weldAngle `required`	number	°	Weld angle
material	object	-	A material object
bevelShape `required`	string	-	Bevel shape: `U` or `V`
symmetry `required`	string	-	Weld symmetry: `Symmetric`, `StraightLeft`, or `StraightRight`
heatAffectedZoneWidth	number	m	HAZ width
offset	number	m
upperCap	object	-	An upperCap object
lowerCap	object	-	A lowerCap object
fills	array	-	A fills array
hotPass	object	-	A hotPass object
land	object	-	A land object
root	object	-	A root object

upperCap¶

Typeobject

Property	Type	Unit	Description
width	number	m
height `required`	number	m

lowerCap¶

Typeobject

Property	Type	Unit	Description
width	number	m
height `required`	number	m

fills¶

Typearray

Property	Type	Unit	Description
angle `required`	number	°
height `required`	number	m

hotPass¶

Typeobject

Property	Type	Unit	Description
angle `required`	number	°
height `required`	number	m

land¶

Typeobject

Property	Type	Unit	Description
height `required`	number	m

root¶

Typeobject

Property	Type	Unit	Description
angle `required`	number	°
height `required`	number	m

customOverlay2D¶

Typeobject

The customOverlay2D object describes a generic custom 2D CAD overlay.

Property	Type	Unit	Description
filename `required`	string	-	File name containing the overlay
format `required`	string	-	File format
extension `required`	string	-	Extension of the file containing the overlay
path `required`	string	-	Path to the file
localScale `required`	object	-	A coordinate object
localTranslation `required`	object	-	A coordinate object
translation `required`	object	-	A coordinate object
scale `required`	number	-	Scale to be applied to the overlay
rotation `required`	number	-	Rotation to be applied to the overlay
width `required`	number	m
thickness `required`	number	m

coordinate¶

Typeobject

Property	Type	Description
x `required`	string
y `required`	string
z `required`	string

Example¶

"specimens": [
  {
    "id": 0,
    "plateGeometry": {
      "width": 0.35000000000000003,
      "length": 0.1,
      "thickness": 0.011,
      "surfaces": [
        {
          "id": 0,
          "name": "Top"
        }
      ],
      "material": {
        "name": "Plexiglass",
        "longitudinalWave": {
          "nominalVelocity": 2700.0,
          "attenuationCoefficient": 0.91
        },
        "transversalVerticalWave": {
          "nominalVelocity": 0.0,
          "attenuationCoefficient": 0.0
        },
        "density": 1.18
      }
    }
  }
]