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 hybrid Python/Julia package to get access to KM3NeT sample files for testing and development
purposes.
Installation and usage
----------------------
Python
``````
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 ``-``).
Julia
`````
Make sure the "KM3NeT Julia Registry" is added to your local Julia registries,
see https://git.km3net.de/common/julia-registry for more information.
The Julia package is called ``KM3NeTTestData`` and can be installed the usual way:
.. code-block:: julia
julia> import Pkg; Pkg.add("KM3NeTTestData")
The package exports the ``datapath()`` function which can be used similar to the Python implementation:
.. code-block:: julia
julia> using KM3NeTTestData
julia> filename = datapath("offline", "km3net_offline.root")
"/Users/tamasgal/.julia/packages/KM3NeTTestData/zb9oT/src/../km3net_testdata/data/offline/km3net_offline.root"
Shell
`````
To use the Python module in e.g. shell scripts, it can be called directly to
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
Raw data
{
"_id": null,
"home_page": "https://git.km3net.de/km3py/km3net-testdata",
"name": "km3net-testdata",
"maintainer": null,
"docs_url": null,
"requires_python": ">=2.7",
"maintainer_email": null,
"keywords": null,
"author": "Tamas Gal",
"author_email": "tgal@km3net.de",
"download_url": "https://files.pythonhosted.org/packages/15/be/efb7b5ef00eaf00cc7dc90e0161ec576dba7728f212f0bd83142a41a3187/km3net_testdata-0.4.18.tar.gz",
"platform": "any",
"description": "KM3NeT TestData\n===============\n\n.. image:: https://git.km3net.de/km3py/km3net-testdata/badges/master/pipeline.svg\n :target: https://git.km3net.de/km3py/km3net-testdata/pipelines\n\n.. image:: https://git.km3net.de/km3py/km3net-testdata/badges/master/coverage.svg\n :target: https://km3py.pages.km3net.de/km3net-testdata/coverage\n\n.. image:: https://git.km3net.de/examples/km3badges/-/raw/master/docs-latest-brightgreen.svg\n :target: https://km3py.pages.km3net.de/km3net-testdata\n\n\nA hybrid Python/Julia package to get access to KM3NeT sample files for testing and development\npurposes.\n\nInstallation and usage\n----------------------\n\nPython\n``````\n\n pip install km3net-testdata\n\nThe file paths can be access in Python scripts using the ``data_path()`` function:\n\n.. code-block:: python\n\n from km3net_testdata import data_path\n\n filename = data_path(\"offline/km3net_offline.root\")\n\nNotice the underscore in the Python package name (PyPI forces ``-`` but Python\npackage names are not allowed to use ``-``).\n\nJulia\n`````\n\nMake sure the \"KM3NeT Julia Registry\" is added to your local Julia registries,\nsee https://git.km3net.de/common/julia-registry for more information.\nThe Julia package is called ``KM3NeTTestData`` and can be installed the usual way:\n\n.. code-block:: julia\n\n julia> import Pkg; Pkg.add(\"KM3NeTTestData\")\n\nThe package exports the ``datapath()`` function which can be used similar to the Python implementation:\n\n.. code-block:: julia\n\n julia> using KM3NeTTestData\n\n julia> filename = datapath(\"offline\", \"km3net_offline.root\")\n \"/Users/tamasgal/.julia/packages/KM3NeTTestData/zb9oT/src/../km3net_testdata/data/offline/km3net_offline.root\"\n\nShell\n`````\n\nTo use the Python module in e.g. shell scripts, it can be called directly to\nprint the filepath:\n\n.. code-block:: shell\n\n $ python -m km3net_testdata offline/km3net_offline.root\n /full/path/to/offline/km3net_offline.root\n\nIt can be combined with other shell tools, as usual:\n\n.. code-block:: shell\n\n $ head -n 5 $(python -m km3net_testdata detx/detx_v3.detx)\n # a comment line\n # another comment line starting with '#'\n 23 v3\n 1500000000.1 9999999999.0\n UTM WGS84 32N 256500.0 4743000.0 -2425.0\n\nAcknowledgements\n----------------\n\nThe project idea and implementation were inspired by the Scikit-HEP Project https://github.com/scikit-hep/scikit-hep-testdata\n\n\n",
"bugtrack_url": null,
"license": null,
"summary": "KM3NeT TestData",
"version": "0.4.18",
"project_urls": {
"Homepage": "https://git.km3net.de/km3py/km3net-testdata"
},
"split_keywords": [],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "55b8c6bdef66f59d0840d6f01eddd1e525b84065d6a111872b476aeeecfcb6b4",
"md5": "e253e75f4b9c4529c1d9e99dc9bc65d6",
"sha256": "b4e4e484636ad2273528420f23561ec49ada5905aef8524e281fa821611b4922"
},
"downloads": -1,
"filename": "km3net_testdata-0.4.18-py3-none-any.whl",
"has_sig": false,
"md5_digest": "e253e75f4b9c4529c1d9e99dc9bc65d6",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=2.7",
"size": 68611530,
"upload_time": "2024-12-10T07:02:14",
"upload_time_iso_8601": "2024-12-10T07:02:14.983250Z",
"url": "https://files.pythonhosted.org/packages/55/b8/c6bdef66f59d0840d6f01eddd1e525b84065d6a111872b476aeeecfcb6b4/km3net_testdata-0.4.18-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "15beefb7b5ef00eaf00cc7dc90e0161ec576dba7728f212f0bd83142a41a3187",
"md5": "6df8c757582ccc26e6e13fd4373a4dc3",
"sha256": "092c058224ca52f447c17bf804f0a41f96831662a1c08a6dfa77f03c3de66745"
},
"downloads": -1,
"filename": "km3net_testdata-0.4.18.tar.gz",
"has_sig": false,
"md5_digest": "6df8c757582ccc26e6e13fd4373a4dc3",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=2.7",
"size": 68459365,
"upload_time": "2024-12-10T07:02:25",
"upload_time_iso_8601": "2024-12-10T07:02:25.516881Z",
"url": "https://files.pythonhosted.org/packages/15/be/efb7b5ef00eaf00cc7dc90e0161ec576dba7728f212f0bd83142a41a3187/km3net_testdata-0.4.18.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-12-10 07:02:25",
"github": false,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"lcname": "km3net-testdata"
}