Metadata-Version: 2.1
Name: km3net-testdata
Version: 0.3.5
Summary: KM3NeT TestData
Home-page: https://git.km3net.de/km3py/km3net-testdata
Author: Tamas Gal
Author-email: tgal@km3net.de
License: UNKNOWN
Platform: any
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Science/Research
Classifier: Programming Language :: Python
Requires-Python: >=2.7
Requires-Dist: importlib-resources
Requires-Dist: setuptools-scm
Provides-Extra: dev
Requires-Dist: matplotlib ; extra == 'dev'
Requires-Dist: memory-profiler ; extra == 'dev'
Requires-Dist: numpydoc ; extra == 'dev'
Requires-Dist: pillow ; extra == 'dev'
Requires-Dist: pytest ; extra == 'dev'
Requires-Dist: pytest-cov ; extra == 'dev'
Requires-Dist: pytest-flake8 ; extra == 'dev'
Requires-Dist: pytest-pylint ; extra == 'dev'
Requires-Dist: pytest-watch ; extra == 'dev'
Requires-Dist: sphinx ; extra == 'dev'
Requires-Dist: sphinx-autoapi ; extra == 'dev'
Requires-Dist: sphinx-gallery (>=0.1.12) ; extra == 'dev'
Requires-Dist: sphinx-rtd-theme ; extra == 'dev'
Requires-Dist: sphinxcontrib-versioning ; extra == 'dev'
Requires-Dist: yapf (>=0.30.0) ; extra == 'dev'
Requires-Dist: wheel ; extra == 'dev'

KM3NeT TestData
===============

.. image:: https://git.km3net.de/km3py/km3net-testdata/badges/master/pipeline.svg
    :target: https://git.km3net.de/km3py/km3net-testdata/pipelines

.. image:: https://git.km3net.de/km3py/km3net-testdata/badges/master/coverage.svg
    :target: https://km3py.pages.km3net.de/km3net-testdata/coverage

.. image:: https://git.km3net.de/examples/km3badges/-/raw/master/docs-latest-brightgreen.svg
    :target: https://km3py.pages.km3net.de/km3net-testdata


A package to get access to KM3NeT sample files for testing and development
purposes.

Installation and usage
----------------------

    pip install km3net-testdata

The file paths can be access in Python scripts using the ``data_path()`` function:

.. code-block:: python

    from km3net_testdata import data_path

    filename = data_path("offline/km3net_offline.root")

Notice the underscore in the Python package name (PyPI forces ``-`` but Python
package names are not allowed to use ``-``).

To use the module in e.g. shell scripts, the module can be called directly and
print the filepath:

.. code-block:: shell

   $ python -m km3net_testdata offline/km3net_offline.root
   /full/path/to/offline/km3net_offline.root

It can be combined with other shell tools, as usual:

.. code-block:: shell

  $ head -n 5 $(python -m km3net_testdata detx/detx_v3.detx)
  # a comment line
  # another comment line starting with '#'
  23 v3
  1500000000.1 9999999999.0
  UTM WGS84 32N 256500.0 4743000.0 -2425.0

Acknowledgements
----------------

The project idea and implementation were inspired by the Scikit-HEP Project https://github.com/scikit-hep/scikit-hep-testdata


