Command line
============

The command-line tools run locally or on a remote machine without interactive
previews. Install Track Analyzer first; see :doc:`installation`. Configure a
dataset directory with:

* ``positions.csv`` containing ``track``, ``frame``, ``x``, ``y``, and
  optionally ``z``;
* ``info.txt`` containing dataset metadata;
* optionally, an image named ``stack.tif`` and configuration files in
  ``config/``.

See :doc:`examples` for datasets and :doc:`quickstart` for the pipeline.
Create default configuration files with ``TA_config`` and edit them to choose
filters and analyses:

.. code-block:: sh

   TA_config /path/to/dataset
   traj_analysis /path/to/dataset
   map_analysis /path/to/dataset

Use ``--refresh`` to regenerate the database and ``--parallelize`` to render
TIFF frames in parallel. Each command provides its own ``--help``. Synthetic
tracks can be generated with ``TA_synthetic /path/to/dataset``; add ``--plot``
to export a TIFF and ``--parallelize`` to render its frames in parallel.
``TA_synthetic`` reads ``config.csv`` in the dataset directory if present,
otherwise it uses its defaults.
