Scan path

adamantine supports two kinds of scan path input: the segment format and the event format.

Segment format

After the self-explainatory tree-line header, the column descriptions are:

  • Column 1: mode 0 for line mode, mode 1 for spot mode
  • Columns 2 to 4: (x,y,z) coordinates in units of m. For line mode, this is the ending position of the line.
  • Column 5: the coefficient for the nominal power. Usually this is either 0 or 1, but sometimes intermediate values are used when turning a corner.
  • Column 6: in spot mode, this is the dwell time in seconds, in line mode this is the velocity in m/s.

The first entry must be a spot. If it was a line, there would be no way to know where the line starts (since the coordinates are the ending coordinates). By convention, we avoid using a zero second dwell time for the first spot and instead choose some small positive number.

An example of such a file can be found here.

Event format

For an event series the first segment is a point, then the rest are lines. The column descriptions are:

  • Column 1: segment endtime
  • Columns 2 to 4: (x,y,z) coordinates in units of m. This is the ending position of the line.
  • Column 5: the coefficient for the nominal power. Usually this is either 0 or 1, but sometimes intermediate values are used when turning a corner.

An example of such a file can be found here.

Five axis

Since version 1.2, the event series format also supports 5-axis builds. The first segment is a point, then the rest are lines. The column descriptions are:

  • Column 1: segment endtime
  • Columns 2 to 4: (x,y,z) coordinates in units of m. This is the ending position of the line in the rotated reference frame.
  • Columns 5 to 8: (r,i,j,k) quaternion of the rotation. This is the rotation performed to go from the build reference frame to the rotated reference frame.
  • Column 9: the coefficient for the nominal power. Usually this is either 0 or 1, but sometimes intermediate values are used when turning a corner.

Rotation is only supported while the heat source is inactive. If the heat source is active, the segment’s quaternion must remain identical to that of the previous segment.

An example of such a file can be found here

This site uses Just the Docs, a documentation theme for Jekyll.