.. _sampleXYfiles-label:
Manual Scanning Path and Power Modulation
=========================================

.. include:: ../shared.rst

Introduction
------------

The beam scanning path can be set with a special file format which is described in the :ref:`Manual Scan Path <xypositions-label>` section of the input file description. 

On this page, we present some samples. 


Single Track
------------

Specify two points: the start and the end of the track.
The file has to have at least three data columns, separated with spaces: time (seconds), and the x- and y- position (meters) of the laser spot at the time. 
If the input file has 3 columns, power and width are set through the setup form. 

.. literalinclude:: ../jsonfiles/xyposfiles/XYscan-singletrack.dat
   :lines: 1-10
   :caption: XYscan-singletrack.dat

Download the full file :download:`here <../jsonfiles/xyposfiles/XYscan-singletrack.dat>`.

.. figure:: ../jsonfiles/xyposfiles/XYscan-singletrack.png

The file can be used in the input as:

.. code:: json

  {
    "ScanStrategy": {
      "Type": "XYpositions",
      "XYpositions": {
          "sourceFile": "XYscan-singletrack.dat"
      }
    }
  }

Several Tracks on one Substrate
-------------------------------
If the input file has 5 columns, power and width are read from file. 

In this sample, the short tracks have equal length, but varied scan speed and power. 
Two points are specified for each track: the start and the end.

The power is turned off at the end of each track. 
The time on each line has to be higher than the time on the previous line, thus, the small time value is added for the start of each track for sharp changes. 

.. literalinclude:: ../jsonfiles/xyposfiles/XYscan-samples.dat
   :lines: 1-10
   :caption: XYscan-samples.dat
   :append: ...

Download the full file :download:`here <../jsonfiles/xyposfiles/XYscan-samples.dat>`.

.. figure:: ../jsonfiles/xyposfiles/XYscan-samples.gif

The file can be used in the input as:

.. code:: json

  {
    "ScanStrategy": {
      "Type": "XYpositions",
      "XYpositions": {
          "sourceFile": "XYscan-samples.dat"
      }
    }
  }

The beam power and spot width specified elsewhere (in the ``ScanStrategy.Beam`` section) will be ignored, since their values are given in the 4-th and 5-th columns of this file. 

Complex Path
------------

The scanning path contains many points that follow the high-resolution curve. 

.. literalinclude:: ../jsonfiles/xyposfiles/XYscan-curve.dat
   :lines: 1-10
   :caption: XYscan-curve.dat
   :append: ...

Download the full file :download:`here <../jsonfiles/xyposfiles/XYscan-curve.dat>`.

.. figure:: ../jsonfiles/xyposfiles/XYscan-curve.gif

Wobbling laser
--------------

The scanning path contains many points that follow the high-resolution wobble path. 
The beam power and beam width can be set in the calculation setup form. 

.. literalinclude:: ../jsonfiles/xyposfiles/XYscan-wobble.dat
   :lines: 1-10
   :caption: XYscan-wobble.dat
   :append: ...

Download the full file :download:`here <../jsonfiles/xyposfiles/XYscan-wobble.dat>`.

.. figure:: ../jsonfiles/xyposfiles/XYscan-wobble.gif