unyt

unyt: Handle, manipulate, and convert data with units in Python - Published in JOSS (2018)

https://github.com/yt-project/unyt

Science Score: 95.0%

This score indicates how likely this project is to be science-related based on various indicators:

  • CITATION.cff file
  • codemeta.json file
    Found codemeta.json file
  • .zenodo.json file
    Found .zenodo.json file
  • DOI references
    Found 6 DOI reference(s) in README and JOSS metadata
  • Academic publication links
    Links to: joss.theoj.org
  • Committers with academic emails
    8 of 38 committers (21.1%) from academic institutions
  • Institutional organization owner
  • JOSS paper metadata
    Published in Journal of Open Source Software

Keywords from Contributors

astrophysics astronomy pde cosmology exoplanet mcmc cfd energy-system mesh download-manager

Scientific Fields

Mathematics Computer Science - 37% confidence
Last synced: 4 months ago · JSON representation

Repository

Handle, manipulate, and convert data with units in Python

Basic Info
  • Host: GitHub
  • Owner: yt-project
  • License: bsd-3-clause
  • Language: Python
  • Default Branch: main
  • Homepage: https://unyt.readthedocs.io
  • Size: 5.42 MB
Statistics
  • Stars: 375
  • Watchers: 12
  • Forks: 52
  • Open Issues: 48
  • Releases: 24
Created over 7 years ago · Last pushed 4 months ago
Metadata Files
Readme Changelog Contributing License Authors Codemeta

README.rst

====
unyt
====


.. image:: https://img.shields.io/pypi/v/unyt.svg
        :target: https://pypi.python.org/pypi/unyt

.. image:: https://img.shields.io/conda/vn/conda-forge/unyt.svg
        :target: https://anaconda.org/conda-forge/unyt
        :alt: conda-forge

.. image:: https://github.com/yt-project/unyt/actions/workflows/ci.yml/badge.svg?branch=main
        :target: https://github.com/yt-project/unyt/actions/workflows/ci.yml

.. image:: https://github.com/yt-project/unyt/actions/workflows/bleeding-edge.yaml/badge.svg?branch=main
        :target: https://github.com/yt-project/unyt/actions/workflows/bleeding-edge.yaml

.. image:: https://readthedocs.org/projects/unyt/badge/?version=latest
        :target: https://unyt.readthedocs.io/en/latest/?badge=latest
        :alt: Documentation Status

.. image:: http://joss.theoj.org/papers/dbc27acb614dd33eb02b029ef20e7fe7/status.svg
        :target: http://joss.theoj.org/papers/dbc27acb614dd33eb02b029ef20e7fe7
        :alt: Code Paper

|

 .. image:: https://raw.githubusercontent.com/yt-project/unyt/master/docs/_static/yt_logo_small.png
         :target: https://yt-project.org
         :alt: The yt Project

A package for handling numpy arrays with units.

Often writing code that deals with data that has units can be confusing. A
function might return an array but at least with plain NumPy arrays, there is no
way to easily tell what the units of the data are without somehow knowing *a
priori*.

The ``unyt`` package (pronounced like "unit") provides a subclass of NumPy's
``ndarray`` class that knows about units. For example, one could do:

    >>> import unyt as u
    >>> distance_traveled = [3.4, 5.8, 7.2] * u.mile
    >>> print(distance_traveled.to('km'))
    [ 5.4717696  9.3341952 11.5872768] km

And a whole lot more! See `the documentation `_ for
installation instructions, more examples, and full API reference.

This package only depends on ``numpy`` and ``sympy``.  Notably, it does *not*
depend on ``yt`` and it is written in pure Python.

Code of Conduct
---------------

The ``unyt`` package is part of `The yt Project
`_. Participating in ``unyt`` development therefore
happens under the auspices of the `yt community code of conduct
`_. If
for any reason you feel that the code of conduct has been violated, please send
an e-mail to confidential@yt-project.org with details describing the
incident. All emails sent to this address will be treated with the strictest
confidence by an individual who does not normally participate in yt development.

License
-------

The unyt package is licensed under the BSD 3-clause license.

Citation
--------

If you make use of unyt in work that leads to a publication we would appreciate
a mention in the text of the paper or in the acknowledgements along with a
citation to our `paper
`_ in the
Journal of Open Source Software. You can use the following BibTeX::

 @article{Goldbaum2018,
   doi = {10.21105/joss.00809},
   url = {https://doi.org/10.21105/joss.00809},
   year  = {2018},
   month = {aug},
   publisher = {The Open Journal},
   volume = {3},
   number = {28},
   pages = {809},
   author = {Nathan J. Goldbaum and John A. ZuHone and Matthew J. Turk and Kacper Kowalik and Anna L. Rosen},
   title = {unyt: Handle,  manipulate,  and convert data with units in Python},
   journal = {Journal of Open Source Software}
 }

Or the following citation format:

  Goldbaum et al., (2018). unyt: Handle, manipulate, and convert data with units in Python . Journal of Open Source Software, 3(28), 809, https://doi.org/10.21105/joss.00809

Owner

  • Name: The yt project
  • Login: yt-project
  • Kind: organization
  • Email: yt-users@python.org

A toolkit for analysis and visualization of volumetric data

JOSS Publication

unyt: Handle, manipulate, and convert data with units in Python
Published
August 15, 2018
Volume 3, Issue 28, Page 809
Authors
Nathan J. Goldbaum ORCID
National Center for Supercomputing Applications, University of Illinois at Urbana-Champaign. 1205 W Clark St, Urbana, IL USA 61801
John A. ZuHone ORCID
Harvard-Smithsonian Center for Astrophysics. 60 Garden St, Cambridge, MA USA 02138
Matthew J. Turk ORCID
National Center for Supercomputing Applications, University of Illinois at Urbana-Champaign. 1205 W Clark St, Urbana, IL USA 61801
Kacper Kowalik ORCID
National Center for Supercomputing Applications, University of Illinois at Urbana-Champaign. 1205 W Clark St, Urbana, IL USA 61801
Anna L. Rosen ORCID
Harvard-Smithsonian Center for Astrophysics. 60 Garden St, Cambridge, MA USA 02138
Editor
Kyle Niemeyer ORCID
Tags
units quantities NumPy sympy

CodeMeta (codemeta.json)

{
  "@context": "https://raw.githubusercontent.com/codemeta/codemeta/master/codemeta.jsonld",
  "@type": "Code",
  "author": [
    {
      "@id": "0000-0001-5557-267X",
      "@type": "Person",
      "email": "ngoldbau@illinois.edu",
      "name": "Nathan Goldbaum",
      "affiliation": "University of Illinois at Urbana Champaign"
    },
    {
      "@id": "0000-0003-3175-2347",
      "@type": "Person",
      "email": "jzuhone@cfa.harvard.edu",
      "name": "John ZuHone",
      "affiliation": "Harvard-Smithsonian Center for Astrophysics"
    },
    {
      "@id": "0000-0002-5294-0198",
      "@type": "Person",
      "email": "mjturk@illinois.edu",
      "name": "Matthew Turk",
      "affiliation": "University of Illinois at Urbana Champaign"
    },
    {
      "@id": "0000-0003-1709-3744",
      "@type": "Person",
      "email": "kowalikk@illinois.edu",
      "name": "Kacper Kowalik",
      "affiliation": "University of Illinois at Urbana Champaign"
    },
    {
      "@id": "0000-0003-4423-0660",
      "@type": "Person",
      "email": "anna.rosen@cfa.harvard.edu",
      "name": "Anna Rosen",
      "affiliation": "Harvard-Smithsonian Center for Astrophysics"
    }
  ],
  "identifier": "",
  "codeRepository": "https://github.com/yt-project/unyt",
  "datePublished": "2018-08-13",
  "dateModified": "2018-08-13",
  "dateCreated": "2018-08-13",
  "description": "Handle, manipulate, and convert data with units in Python",
  "keywords": "units, python, numpy, sympy, quantities",
  "license": "BSD",
  "title": "unyt",
  "version": "v1.0.7"
}

GitHub Events

Total
  • Create event: 7
  • Release event: 1
  • Issues event: 29
  • Watch event: 11
  • Delete event: 10
  • Member event: 2
  • Issue comment event: 126
  • Push event: 36
  • Pull request review event: 52
  • Pull request review comment event: 42
  • Pull request event: 68
  • Fork event: 4
Last Year
  • Create event: 7
  • Release event: 1
  • Issues event: 29
  • Watch event: 11
  • Delete event: 10
  • Member event: 2
  • Issue comment event: 126
  • Push event: 36
  • Pull request review event: 52
  • Pull request review comment event: 42
  • Pull request event: 68
  • Fork event: 4

Committers

Last synced: 5 months ago

All Time
  • Total Commits: 1,834
  • Total Committers: 38
  • Avg Commits per committer: 48.263
  • Development Distribution Score (DDS): 0.641
Past Year
  • Commits: 58
  • Committers: 7
  • Avg Commits per committer: 8.286
  • Development Distribution Score (DDS): 0.603
Top Committers
Name Email Commits
Nathan Goldbaum n****u@i****u 658
Clément Robert c****2@p****m 363
John ZuHone j****e@g****m 316
Nathan Goldbaum n****3@g****m 111
Lee Johnston l****n@n****m 68
chrishavlin c****n@g****m 66
pre-commit-ci[bot] 6****] 58
Andrei Berceanu a****u@g****m 37
Matthew Turk m****k@g****m 35
Kacper Kowalik x****k@g****m 14
Matthew Feickert m****t@c****h 12
Kyle Oman k****n@d****k 12
Josh Borrow j****h@j****m 10
Daniel Bates d****s@m****m 9
Kyle Sunden s****n@w****u 6
Sam Dotson s****n@g****m 6
Ben Thompson n****e@n****e 6
Britton Smith b****h@g****m 5
David Hannasch D****h@g****m 4
Jeroen Van Goey j****y@g****m 4
Ben Kimock k****b@g****m 4
Andrew Myers a****2@g****m 4
Thomas Hisch t****h@g****m 4
Youness Bougteb s****b@g****m 3
Ricarda Beckmann r****n@a****k 2
Michael Zingale m****e@s****u 2
Miguel de Val-Borro m****l@g****m 2
Peter Talley p****y@g****m 2
dependabot[bot] 4****] 2
qobilidop q****p@g****m 1
and 8 more...

Issues and Pull Requests

Last synced: 4 months ago

All Time
  • Total issues: 70
  • Total pull requests: 235
  • Average time to close issues: 2 months
  • Average time to close pull requests: 16 days
  • Total issue authors: 35
  • Total pull request authors: 13
  • Average comments per issue: 3.81
  • Average comments per pull request: 1.55
  • Merged pull requests: 204
  • Bot issues: 0
  • Bot pull requests: 48
Past Year
  • Issues: 25
  • Pull requests: 60
  • Average time to close issues: about 1 month
  • Average time to close pull requests: 15 days
  • Issue authors: 13
  • Pull request authors: 7
  • Average comments per issue: 1.64
  • Average comments per pull request: 2.1
  • Merged pull requests: 44
  • Bot issues: 0
  • Bot pull requests: 18
Top Authors
Issue Authors
  • neutrinoceros (23)
  • kyleaoman (9)
  • ngoldbaum (3)
  • Cpp87 (2)
  • MatthieuSchaller (2)
  • JBorrow (2)
  • yohad (1)
  • vdbma (1)
  • zingale (1)
  • berceanu (1)
  • aaramburo (1)
  • CalCraven (1)
  • james-trayford (1)
  • cbyrohl (1)
  • chrisjonesBSU (1)
Pull Request Authors
  • neutrinoceros (158)
  • pre-commit-ci[bot] (48)
  • kyleaoman (16)
  • jzuhone (12)
  • zingale (4)
  • ngoldbaum (3)
  • dependabot[bot] (3)
  • JBorrow (2)
  • yuyttenhove (2)
  • BioGeek (2)
  • haymanpf (1)
  • samgdotson (1)
  • db434 (1)
Top Labels
Issue Labels
bug (16) question (1) help wanted (1) good first issue (1)
Pull Request Labels
bug (56) enhancement (8) dependencies (5)

Packages

  • Total packages: 3
  • Total downloads:
    • pypi 34,479 last-month
  • Total dependent packages: 29
    (may contain duplicates)
  • Total dependent repositories: 79
    (may contain duplicates)
  • Total versions: 60
  • Total maintainers: 3
pypi.org: unyt

A package for handling numpy arrays with units

  • Versions: 35
  • Dependent Packages: 20
  • Dependent Repositories: 51
  • Downloads: 34,479 Last month
  • Docker Downloads: 0
Rankings
Dependent packages count: 0.7%
Dependent repos count: 2.1%
Docker downloads count: 2.3%
Downloads: 2.5%
Average: 2.8%
Stargazers count: 3.5%
Forks count: 6.0%
Maintainers (3)
Last synced: 4 months ago
conda-forge.org: unyt
  • Versions: 23
  • Dependent Packages: 8
  • Dependent Repositories: 14
Rankings
Dependent packages count: 7.1%
Dependent repos count: 9.5%
Average: 16.3%
Stargazers count: 21.9%
Forks count: 26.6%
Last synced: 4 months ago
anaconda.org: unyt

A package for handling numpy arrays with units. Often writing code that deals with data that has units can be confusing. A function might return an array but at least with plain NumPy arrays, there is no way to easily tell what the units of the data are without somehow knowing them prior. The unyt package (pronounced like "unit") provides a subclass of NumPy's ndarray class that knows about units.

  • Versions: 2
  • Dependent Packages: 1
  • Dependent Repositories: 14
Rankings
Dependent packages count: 30.6%
Stargazers count: 35.0%
Average: 35.1%
Dependent repos count: 35.5%
Forks count: 39.3%
Last synced: 4 months ago

Dependencies

docs/requirements.txt pypi
  • matplotlib *
  • numpy *
  • sphinx *
  • sympy *
.github/workflows/bleeding-edge.yaml actions
  • actions/checkout v3 composite
  • actions/setup-python v4 composite
.github/workflows/ci.yml actions
  • actions/checkout v3 composite
  • actions/setup-python v4 composite
pyproject.toml pypi
  • numpy >=1.19
  • packaging >=20.9
  • sympy >=1.5