[](https://codeberg.org/Cs137/NuPaAc/src/branch/main/LICENSE)
[](https://pypi.org/project/NuPaAc/)
[](https://pepy.tech/projects/nupaac)
# NuPaAc - Nuclide Pandas Accessor
This python package provides the `NuclideSeriesAccessor` class, which acts as kind
of wrapper to interact with
[radioactivedecay `Nuclide`](https://radioactivedecay.github.io/nuclide.html?highlight=nuclide#id1)
objects from nuclide strings containing pandas `Series`. For detailed information
about the radioactivedecay package, see its [documentation](https://radioactivedecay.github.io/).
The series accessor allows to retrive several data series obtained from the dataset
in use by `radioactivedecay`. Where appropriate, data are returned as
[pint series](https://codeberg.org/Cs137/NuPaAc/src/branch/main/tutorial.md#pint-series),
allowing to preserve the unit and perform unit-aware operations.
The functionality is implemented via the [`pint-pandas` package](https://github.com/hgrecco/pint-pandas).
__Consult the [`tutorial.md` file](https://codeberg.org/Cs137/NuPaAc/src/branch/main/tutorial.md)
to learn about the functionality provided by this package.__
```{warning}
The project is currently under development and changes in its behaviour might be introduced.
```
## Installation
Install the latest release of UnPaAc from [PyPI](https://pypi.org/project/nupaac/)
via `pip`:
```sh
$ pip install nupaac
```
The development version can be installed from
[the Git repository](https://codeberg.org/Cs137/NuPaAc) using `pip`:
```sh
# Via https
pip install git+https://codeberg.org/Cs137/NuPaAc.git
# Via ssh
pip install git+ssh://git@codeberg.org:Cs137/NuPaAc.git
```
## Usage
The pandas `Series` accessor is available via the `nucs` attribute of Series
instances. In order to make use of the accessor, import the module `nucs` from
this package.
__Examples demonstrating several use cases can be found in the
[`tutorial.md` file](https://codeberg.org/Cs137/NuPaAc/src/branch/main/tutorial.md).__
## Changes
All notable changes to this project are documented in the
[`CHANGELOG.md` file](https://codeberg.org/Cs137/NuPaAc/src/branch/main/CHANGELOG.md).
## Contributing
Contributions to the `NuPaAc` package are very welcomed. Feel free to submit a
pull request, if you would like to contribute to the project. In case you are
unfamiliar with the process, consult the
[forgejo documentation](https://forgejo.org/docs/latest/user/pull-requests-and-git-flow/)
and follow the steps using this repository instead of the `example` repository.
Create your [pull request (PR)](https://codeberg.org/Cs137/NuPaAc/pulls) to
inform that you start working on a contribution. Provide a clear description
of your envisaged changes and the motivation behind them, prefix the PR's title
with ``WIP: `` until your changes are finalised.
All kind of contributions are appreciated, whether they are
bug fixes, new features, or improvements to the documentation.
## Development
### Installing for development
To install the package in development mode, clone the Git repository and install
the package using Poetry, as shown in the code block underneath. To install Poetry,
which is required for virtual environment and dependency management, follow the
instructions on the [Poetry website](https://python-poetry.org/docs/#installation).
```bash
git clone https://codeberg.org/Cs137/NuPaAc.git
cd nupaac
poetry install
```
This will create a virtual environment and install the package dependencies and
the package itself in editable mode, allowing you to make changes to the code and
see the effects immediately in the corresponding virtual environment. Alternatively,
you can install it via `pip install -e` in an existing virtual environment.
## License
NuPaAc is open source software released under the MIT License.
See [LICENSE](https://codeberg.org/Cs137/NuPaAc/src/branch/main/LICENSE) file for details.
---
This package was created and is maintained by Christian Schreinemachers, (C) 2025.
Raw data
{
"_id": null,
"home_page": null,
"name": "nupaac",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.9",
"maintainer_email": null,
"keywords": "radioactive, nuclides, radionuclides, radio chemistry, nuclear chemistry, physics, health physics, half-life, science, pandas, series",
"author": "Christian Schreinemachers (Cs137)",
"author_email": null,
"download_url": "https://files.pythonhosted.org/packages/e5/90/4dff1fe438cd2062270e6f11bb8528744310bb97412db4668aa0b40eef62/nupaac-0.1.6.tar.gz",
"platform": null,
"description": "[](https://codeberg.org/Cs137/NuPaAc/src/branch/main/LICENSE)\n[](https://pypi.org/project/NuPaAc/)\n[](https://pepy.tech/projects/nupaac)\n\n\n# NuPaAc - Nuclide Pandas Accessor\n\nThis python package provides the `NuclideSeriesAccessor` class, which acts as kind\nof wrapper to interact with\n[radioactivedecay `Nuclide`](https://radioactivedecay.github.io/nuclide.html?highlight=nuclide#id1)\nobjects from nuclide strings containing pandas `Series`. For detailed information\nabout the radioactivedecay package, see its [documentation](https://radioactivedecay.github.io/).\n\nThe series accessor allows to retrive several data series obtained from the dataset\nin use by `radioactivedecay`. Where appropriate, data are returned as\n[pint series](https://codeberg.org/Cs137/NuPaAc/src/branch/main/tutorial.md#pint-series),\nallowing to preserve the unit and perform unit-aware operations.\nThe functionality is implemented via the [`pint-pandas` package](https://github.com/hgrecco/pint-pandas).\n\n__Consult the [`tutorial.md` file](https://codeberg.org/Cs137/NuPaAc/src/branch/main/tutorial.md)\nto learn about the functionality provided by this package.__\n\n\n```{warning}\nThe project is currently under development and changes in its behaviour might be introduced.\n```\n\n\n## Installation\n\nInstall the latest release of UnPaAc from [PyPI](https://pypi.org/project/nupaac/)\nvia `pip`:\n\n```sh\n$ pip install nupaac\n```\n\nThe development version can be installed from\n[the Git repository](https://codeberg.org/Cs137/NuPaAc) using `pip`:\n\n```sh\n# Via https\npip install git+https://codeberg.org/Cs137/NuPaAc.git\n\n# Via ssh\npip install git+ssh://git@codeberg.org:Cs137/NuPaAc.git\n```\n\n\n## Usage\n\nThe pandas `Series` accessor is available via the `nucs` attribute of Series\ninstances. In order to make use of the accessor, import the module `nucs` from\nthis package.\n\n__Examples demonstrating several use cases can be found in the\n[`tutorial.md` file](https://codeberg.org/Cs137/NuPaAc/src/branch/main/tutorial.md).__\n\n\n## Changes\n\nAll notable changes to this project are documented in the\n[`CHANGELOG.md` file](https://codeberg.org/Cs137/NuPaAc/src/branch/main/CHANGELOG.md).\n\n\n## Contributing\n\nContributions to the `NuPaAc` package are very welcomed. Feel free to submit a\npull request, if you would like to contribute to the project. In case you are\nunfamiliar with the process, consult the\n[forgejo documentation](https://forgejo.org/docs/latest/user/pull-requests-and-git-flow/)\nand follow the steps using this repository instead of the `example` repository.\n\nCreate your [pull request (PR)](https://codeberg.org/Cs137/NuPaAc/pulls) to\ninform that you start working on a contribution. Provide a clear description\nof your envisaged changes and the motivation behind them, prefix the PR's title\nwith ``WIP: `` until your changes are finalised.\n\nAll kind of contributions are appreciated, whether they are\nbug fixes, new features, or improvements to the documentation.\n\n\n## Development\n\n### Installing for development\n\nTo install the package in development mode, clone the Git repository and install\nthe package using Poetry, as shown in the code block underneath. To install Poetry,\nwhich is required for virtual environment and dependency management, follow the\ninstructions on the [Poetry website](https://python-poetry.org/docs/#installation).\n\n```bash\ngit clone https://codeberg.org/Cs137/NuPaAc.git\ncd nupaac\npoetry install\n```\n\nThis will create a virtual environment and install the package dependencies and\nthe package itself in editable mode, allowing you to make changes to the code and\nsee the effects immediately in the corresponding virtual environment. Alternatively,\nyou can install it via `pip install -e` in an existing virtual environment.\n\n\n## License\n\nNuPaAc is open source software released under the MIT License.\nSee [LICENSE](https://codeberg.org/Cs137/NuPaAc/src/branch/main/LICENSE) file for details.\n\n---\n\nThis package was created and is maintained by Christian Schreinemachers, (C) 2025.\n\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "Pandas Series accessor to handle nuclides.",
"version": "0.1.6",
"project_urls": {
"Changelog": "https://codeberg.org/Cs137/NuPaAc/src/branch/main/CHANGELOG.md",
"Issues": "https://codeberg.org/Cs137/NuPaAc/issues",
"Repository": "https://codeberg.org/Cs137/NuPaAc"
},
"split_keywords": [
"radioactive",
" nuclides",
" radionuclides",
" radio chemistry",
" nuclear chemistry",
" physics",
" health physics",
" half-life",
" science",
" pandas",
" series"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "918121da3d1d4226856187d33f4860bb723cdbe2c58c9ddf587b0a66d3a7a5af",
"md5": "cc690ac7384cf40f12be82765fecc823",
"sha256": "62d1e5023d1777db0f714845f25400375893a671666825b1ae2d0b0a978f17f6"
},
"downloads": -1,
"filename": "nupaac-0.1.6-py3-none-any.whl",
"has_sig": false,
"md5_digest": "cc690ac7384cf40f12be82765fecc823",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.9",
"size": 6302,
"upload_time": "2025-02-20T12:43:07",
"upload_time_iso_8601": "2025-02-20T12:43:07.287137Z",
"url": "https://files.pythonhosted.org/packages/91/81/21da3d1d4226856187d33f4860bb723cdbe2c58c9ddf587b0a66d3a7a5af/nupaac-0.1.6-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "e5904dff1fe438cd2062270e6f11bb8528744310bb97412db4668aa0b40eef62",
"md5": "352259bc8d0a2f9704ce7426d0863753",
"sha256": "412026ee916fec3268ee6bbee33bc46ac6791dac50ce32ac41d442c36f61ef4c"
},
"downloads": -1,
"filename": "nupaac-0.1.6.tar.gz",
"has_sig": false,
"md5_digest": "352259bc8d0a2f9704ce7426d0863753",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.9",
"size": 5870,
"upload_time": "2025-02-20T12:43:08",
"upload_time_iso_8601": "2025-02-20T12:43:08.536826Z",
"url": "https://files.pythonhosted.org/packages/e5/90/4dff1fe438cd2062270e6f11bb8528744310bb97412db4668aa0b40eef62/nupaac-0.1.6.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-02-20 12:43:08",
"github": false,
"gitlab": false,
"bitbucket": false,
"codeberg": true,
"codeberg_user": "Cs137",
"codeberg_project": "NuPaAc",
"lcname": "nupaac"
}
JSON