Metadata-Version: 2.1
Name: trx-python
Version: 0.2.6
Summary: Experiments with new file format for tractography
Home-page: https://github.com/tee-ar-ex/trx-python
License: BSD License
Platform: OS Independent
Classifier: Development Status :: 3 - Alpha
Classifier: Environment :: Console
Classifier: Intended Audience :: Science/Research
Classifier: License :: OSI Approved :: BSD License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Topic :: Scientific/Engineering
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: setuptools_scm
Requires-Dist: deepdiff
Requires-Dist: nibabel>=5
Requires-Dist: numpy>=1.22
Provides-Extra: doc
Requires-Dist: astroid==2.15.8; extra == "doc"
Requires-Dist: sphinx; extra == "doc"
Requires-Dist: pydata-sphinx-theme; extra == "doc"
Requires-Dist: sphinx-autoapi; extra == "doc"
Requires-Dist: numpydoc; extra == "doc"
Provides-Extra: test
Requires-Dist: flake8; extra == "test"
Requires-Dist: psutil; extra == "test"
Requires-Dist: pytest>=7; extra == "test"
Requires-Dist: pytest-console-scripts>=0; extra == "test"
Provides-Extra: all
Requires-Dist: astroid==2.15.8; extra == "all"
Requires-Dist: sphinx; extra == "all"
Requires-Dist: pydata-sphinx-theme; extra == "all"
Requires-Dist: sphinx-autoapi; extra == "all"
Requires-Dist: numpydoc; extra == "all"
Requires-Dist: flake8; extra == "all"
Requires-Dist: psutil; extra == "all"
Requires-Dist: pytest>=7; extra == "all"
Requires-Dist: pytest-console-scripts>=0; extra == "all"

# trx-python

This is a Python implementation of the trx file-format for tractography data.

For details, please visit the documentation web-page at https://tee-ar-ex.github.io/trx-python/.

To install this, you can run:

    pip install trx-python

Or, to install from source:

    git clone https://github.com/tee-ar-ex/trx-python.git
    cd trx-python
    pip install .

### Temporary Directory
The TRX file format uses memmaps to limit RAM usage. When dealing with large files this means several gigabytes could be required on disk (instead of RAM). 

By default, the temporary directory on Linux and MacOS is `/tmp` and on Windows it should be `C:\WINDOWS\Temp`.

If you wish to change the directory add the following variable to your script or to your .bashrc or .bash_profile:
`export TRX_TMPDIR=/WHERE/I/WANT/MY/TMP/DATA` (a)
OR
`export TRX_TMPDIR=use_working_dir` (b)

The provided folder must already exists (a). `use_working_dir` will be the directory where the code is being executed from (b).

The temporary folders should be automatically cleaned. But, if the code crash unexpectedly, make sure the folders are deleted.
