SAPPHiRE — A Framework for HiSPARC
===================================
Introduction
------------
.. image:: https://img.shields.io/pypi/v/hisparc-sapphire
:target: https://pypi.python.org/pypi/hisparc-sapphire/
.. image:: https://img.shields.io/badge/license-GPLv3-blue
:target: https://github.com/HiSPARC/sapphire/blob/master/LICENSE
.. image:: https://img.shields.io/github/actions/workflow/status/HiSPARC/sapphire/tests.yml?branch=master
:target: https://github.com/HiSPARC/sapphire/actions
SAPPHiRE is a Simulation and Analysis Program Package for `HiSPARC
<https://www.hisparc.nl/>`_ Research and Education. It was created in the
process of completing the PhD research of David Fokkema. The history of this
repository contains the complete simulation, analysis and plot generation code
that formed the basis for David's `thesis
<https://www.nikhef.nl/pub/services/biblio/theses_pdf/thesis_D_Fokkema.pdf>`_.
Arne de Laat took over development of SAPPHiRE while working on his own PhD
research.
This repository is created with a sole purpose in mind: to enable HiSPARC
students, teachers and researchers to easily gain access to the data and
perform common simulation and analysis tasks. Historically, starting work
on the data, or extending an existing analysis code, has involved
elaborate installation instructions, heavy customizations to the software,
countless hours going over opaque parts of code and a general feeling of
anguish and despair. SAPPHiRE's ultimate goal: no more of that.
Installation
------------
Required: Python. pip will take care of dependencies, but installing
numpy, scipy and pytables from a python distribution is preferred. We use
miniconda, which includes the conda package manager.
First, `install conda <https://docs.conda.io/en/latest/miniconda.html>`_
and optionally create a virtualenv::
$ conda create --name hisparc python numpy scipy pytables
$ source activate hisparc
or alternatively just install the dependencies::
$ conda install numpy scipy pytables sphinx
Then, using pip::
$ pip install hisparc-sapphire
This should install sapphire with all requirements. More extensive
installation instructions are available in the documentation in the
``doc/`` directory. You can compile them using Sphinx, or you can
follow this link: https://docs.hisparc.nl/sapphire/.
To check if it worked start Python and load the package:
.. code-block:: python
import sapphire
You're done!
Development
-----------
Install python (preferably using conda) as described above but clone
the sapphire repo instead of installing using pip::
$ git clone https://github.com/HiSPARC/sapphire.git
$ cd sapphire
$ pip install -e .[dev]
Version release
---------------
Important: First check if the last commit passes the tests on GitHub Actions!
To release a new version modify the version number in ``setup.py``. Then
create a commit for the new release with a title like 'Bump version to vX.Y.Z'
and a message that contains a summary of the most important changes since the
last release. Then tag the commit and push it to GitHub::
$ git tag vX.Y.Z
$ git push --tags
Then upload the new version to PyPI (this requires the ``build``, ``wheel`` and ``twine``
packages)::
$ python -m build
$ twine upload dist/hisparc-sapphire-X.Y.Z.tar.gz
$ twine upload dist/hisparc_sapphire-X.Y.Z-py3-none-any.whl
The latest version is then available from PyPI.
Raw data
{
"_id": null,
"home_page": null,
"name": "hisparc-sapphire",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.9",
"maintainer_email": "Arne de Laat <arne@delaat.net>",
"keywords": "cosmic rays, detectors, astrophysics, HiSPARC, Nikhef, University of Utah",
"author": "David Fokkema, Tom Kooij",
"author_email": "Arne de Laat <arne@delaat.net>",
"download_url": "https://files.pythonhosted.org/packages/3c/4f/463b7aee4adf78982ddfe0f67f3992c2e79df1def192c72892b9f6155244/hisparc_sapphire-3.1.0.tar.gz",
"platform": null,
"description": "SAPPHiRE \u2014 A Framework for HiSPARC\n===================================\n\nIntroduction\n------------\n\n.. image:: https://img.shields.io/pypi/v/hisparc-sapphire\n :target: https://pypi.python.org/pypi/hisparc-sapphire/\n.. image:: https://img.shields.io/badge/license-GPLv3-blue\n :target: https://github.com/HiSPARC/sapphire/blob/master/LICENSE\n.. image:: https://img.shields.io/github/actions/workflow/status/HiSPARC/sapphire/tests.yml?branch=master\n :target: https://github.com/HiSPARC/sapphire/actions\n\nSAPPHiRE is a Simulation and Analysis Program Package for `HiSPARC\n<https://www.hisparc.nl/>`_ Research and Education. It was created in the\nprocess of completing the PhD research of David Fokkema. The history of this\nrepository contains the complete simulation, analysis and plot generation code\nthat formed the basis for David's `thesis\n<https://www.nikhef.nl/pub/services/biblio/theses_pdf/thesis_D_Fokkema.pdf>`_.\nArne de Laat took over development of SAPPHiRE while working on his own PhD\nresearch.\n\nThis repository is created with a sole purpose in mind: to enable HiSPARC\nstudents, teachers and researchers to easily gain access to the data and\nperform common simulation and analysis tasks. Historically, starting work\non the data, or extending an existing analysis code, has involved\nelaborate installation instructions, heavy customizations to the software,\ncountless hours going over opaque parts of code and a general feeling of\nanguish and despair. SAPPHiRE's ultimate goal: no more of that.\n\n\nInstallation\n------------\n\nRequired: Python. pip will take care of dependencies, but installing\nnumpy, scipy and pytables from a python distribution is preferred. We use\nminiconda, which includes the conda package manager.\n\nFirst, `install conda <https://docs.conda.io/en/latest/miniconda.html>`_\nand optionally create a virtualenv::\n\n $ conda create --name hisparc python numpy scipy pytables\n $ source activate hisparc\n\nor alternatively just install the dependencies::\n\n $ conda install numpy scipy pytables sphinx\n\nThen, using pip::\n\n $ pip install hisparc-sapphire\n\nThis should install sapphire with all requirements. More extensive\ninstallation instructions are available in the documentation in the\n``doc/`` directory. You can compile them using Sphinx, or you can\nfollow this link: https://docs.hisparc.nl/sapphire/.\n\nTo check if it worked start Python and load the package:\n\n.. code-block:: python\n\n import sapphire\n\nYou're done!\n\n\nDevelopment\n-----------\n\nInstall python (preferably using conda) as described above but clone\nthe sapphire repo instead of installing using pip::\n\n $ git clone https://github.com/HiSPARC/sapphire.git\n $ cd sapphire\n $ pip install -e .[dev]\n\n\nVersion release\n---------------\n\nImportant: First check if the last commit passes the tests on GitHub Actions!\n\nTo release a new version modify the version number in ``setup.py``. Then\ncreate a commit for the new release with a title like 'Bump version to vX.Y.Z'\nand a message that contains a summary of the most important changes since the\nlast release. Then tag the commit and push it to GitHub::\n\n $ git tag vX.Y.Z\n $ git push --tags\n\nThen upload the new version to PyPI (this requires the ``build``, ``wheel`` and ``twine``\npackages)::\n\n $ python -m build\n $ twine upload dist/hisparc-sapphire-X.Y.Z.tar.gz\n $ twine upload dist/hisparc_sapphire-X.Y.Z-py3-none-any.whl\n\nThe latest version is then available from PyPI.\n",
"bugtrack_url": null,
"license": null,
"summary": "A framework for the HiSPARC experiment",
"version": "3.1.0",
"project_urls": {
"Documentation": "https://docs.hisparc.nl/sapphire/",
"Homepage": "https://data.hisparc.nl",
"Issues": "https://github.com/HiSPARC/sapphire/issues",
"Repository": "https://github.com/hisparc/sapphire/"
},
"split_keywords": [
"cosmic rays",
" detectors",
" astrophysics",
" hisparc",
" nikhef",
" university of utah"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "a9f97a16aa613e212b16a2c7b28c9b0df54a1625eff97e9d9e861a3f4f895571",
"md5": "67cfd8444e52bb6b6072fbb7f8d905ee",
"sha256": "9360992ccbd03d75eab036c519402ebe69d848c9ffa3fe9160491cc2d1d09121"
},
"downloads": -1,
"filename": "hisparc_sapphire-3.1.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "67cfd8444e52bb6b6072fbb7f8d905ee",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.9",
"size": 7233837,
"upload_time": "2024-07-07T09:51:53",
"upload_time_iso_8601": "2024-07-07T09:51:53.593252Z",
"url": "https://files.pythonhosted.org/packages/a9/f9/7a16aa613e212b16a2c7b28c9b0df54a1625eff97e9d9e861a3f4f895571/hisparc_sapphire-3.1.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "3c4f463b7aee4adf78982ddfe0f67f3992c2e79df1def192c72892b9f6155244",
"md5": "f1c3ec45c4f1b3f7ccea797c06efcce4",
"sha256": "1eb5fbcae89d23e20bc9a134f7cc74530ffc243119e495c7179f218b10eb3401"
},
"downloads": -1,
"filename": "hisparc_sapphire-3.1.0.tar.gz",
"has_sig": false,
"md5_digest": "f1c3ec45c4f1b3f7ccea797c06efcce4",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.9",
"size": 7473426,
"upload_time": "2024-07-07T09:52:02",
"upload_time_iso_8601": "2024-07-07T09:52:02.638111Z",
"url": "https://files.pythonhosted.org/packages/3c/4f/463b7aee4adf78982ddfe0f67f3992c2e79df1def192c72892b9f6155244/hisparc_sapphire-3.1.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-07-07 09:52:02",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "HiSPARC",
"github_project": "sapphire",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "hisparc-sapphire"
}
JSON
