.. _ts_tools:

.. |br| raw:: html

   <br />


ts_tools
============  

.. caution::
   ts_tools is only working on a survey directory structure!
   
**ts_tools** can do a lot of conversions *but* relies on the underlying  :ref:`survey structure <survey_folder_structure>` |br|
the software tries to find **/db/calibration.sql3** inside for safe calibration import (or less save cal/XXXX.txt files).

When simple or unstructured files are imported - at least a good try is possible to create a structured site.





.. _ats2xml:

ats2xml
---------

For import old ats files you may need to create a xml file. |br|
The procedure is shown here: |br|
(click to enlarge the video)

.. raw:: html 

   <div align="center">
   <video width=100%;max-width:100%; height:auto; controls>
   <source src="../../_static/videos/ats2xml.mp4" type="video/mp4">
   Your browser does not support the video tag.
   </video>
   </div>



.. _ascii2ats:

ascii2ats
-----------

On the tab ascii2ats you can import ASCII data **AFTER** configuring a survey structure in the ats2xml tab. |br|
(click to enlarge the video)

.. raw:: html 

   <div align="center">
   <video width=100%;max-width:100%; height:auto; controls>
   <source src="../../_static/videos/ascii_import.mp4" type="video/mp4">
   Your browser does not support the video tag.
   </video>
   </div>
   
You can choose other sensors; "NANOT" is for the case the timeseries are already converted into nano Tesla.

.. _tscat:

.. index::
   single: tscat

tscat
----------

Watch the video to see how to use  `tscat tab <https://youtu.be/RB6eqmVhRlM?si=FPeY6oTsI4Pzxevq>`_. |br|

 
.. _tsdiff:
 
tsdiff
--------

tsdiff simply subtracts channels from each other and creates an atsfile containing the difference. |br|
Timeseries may not look exactly the same: they contain self-noise. In case you look at 16384 Hz sample rate data, the timeseries conatain signal and self-noise. The self-noise partly stacks away or can be reduced additionally be remote referencing, where you look at Hx*Hx_r for example.

The major purpose of tsdiff is to easily find abnormal differences of two parallel orientated sensors.