vector 1.3.0__tar.gz → 1.6.0__tar.gz

{vector-1.3.0 → vector-1.6.0}/.github/CONTRIBUTING.md

@@ -51,13 +51,13 @@ The developer installation of `vector` comes with several options -
 These options can be used with `pip` with the editable (`-e`) mode of installation in the following way -
 
 ```bash
-pip install -e .[dev,test]
+pip install -e ".[dev, test]"
 ```
 
 For example, if you want to install the `docs` dependencies along with the dependencies included above, use -
 
 ```bash
-pip install -e .[dev,test,docs]
+pip install -e ".[dev, test, docs]"
 ```
 
 Furthermore, `vector` can also be installed using `conda`. This installation also requires using a virtual environment -

vector-1.6.0/.github/workflows/cd.yml

@@ -0,0 +1,56 @@
+name: CD
+
+on:
+  workflow_dispatch:
+  release:
+    types:
+      - published
+
+jobs:
+  dist:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - uses: hynek/build-and-inspect-python-package@v2
+
+  publish:
+    needs: [dist]
+    runs-on: ubuntu-latest
+    if: github.event_name == 'release' && github.event.action == 'published'
+    environment:
+      name: pypi
+      url: https://pypi.org/p/vector
+    permissions:
+      id-token: write
+      attestations: write
+
+    steps:
+      - uses: actions/download-artifact@v4
+        with:
+          name: Packages
+          path: dist
+
+      - name: List distributions to be deployed
+        run: ls -l dist/
+
+      - name: Generate artifact attestation for sdist and wheel
+        uses: actions/attest-build-provenance@7668571508540a607bdfd90a87a560489fe372eb # v2.1.0
+        with:
+          subject-path: "dist/vector-*"
+
+      - name: Verify sdist artifact attestation
+        env:
+          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+        run: gh attestation verify dist/vector-*.tar.gz --repo ${{ github.repository }}
+
+      - name: Verify wheel artifact attestation
+        env:
+          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+        run: gh attestation verify dist/vector-*.whl --repo ${{ github.repository }}
+
+      - uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          attestations: true

vector-1.6.0/.github/workflows/ci.yml

@@ -0,0 +1,134 @@
+name: CI
+
+on:
+  pull_request:
+  push:
+    branches:
+      - main
+      - develop
+  workflow_dispatch:
+
+concurrency:
+  # Skip intermediate builds: always.
+  # Cancel intermediate builds: only if it is a pull request build.
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: ${{ startsWith(github.ref, 'refs/pull/') }}
+
+env:
+  # The "FORCE_COLOR" variable, when set to 1,
+  # tells Nox to colorize itself.
+  FORCE_COLOR: "1"
+
+jobs:
+  pre-commit:
+    runs-on: ubuntu-latest
+    name: Check SDist
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: 3.x
+      - uses: astral-sh/setup-uv@v5
+      - name: PyLint
+        run: uvx nox -s pylint -- --output-format=github
+
+  check-lite:
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        python-version:
+          - "3.8"
+          - "3.9"
+          - "3.10"
+          - "3.11"
+          - "3.12"
+          - "3.13"
+    name: Python ${{ matrix.python-version }} - Lite
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+          allow-prereleases: true
+
+      - uses: astral-sh/setup-uv@v5
+
+      - name: Test lite package
+        run: uvx nox -s lite-${{ matrix.python-version }} --verbose
+
+  check-full:
+    needs: [check-lite]
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        python-version:
+          - "3.8"
+          - "3.9"
+          - "3.10"
+          - "3.11"
+          - "3.12"
+          - "3.13"
+    name: Python ${{ matrix.python-version }} - Full
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+          allow-prereleases: true
+
+      - uses: astral-sh/setup-uv@v5
+
+      - name: Install nox
+        run: uv tool install nox
+
+      - name: Run doctests on Python 3.11
+        if: matrix.python-version == 3.11
+        run: nox -s doctests-${{ matrix.python-version }} --verbose
+
+      - name: Test package and generate coverage report
+        run: nox -s coverage-${{ matrix.python-version }} --verbose
+
+      - name: Upload coverage report
+        uses: codecov/codecov-action@v5.1.2
+        with:
+          token: ${{ secrets.CODECOV_TOKEN }}
+
+  discheck:
+    runs-on: ubuntu-latest
+    name: Disassemble check
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: 3.8.13
+
+      - uses: astral-sh/setup-uv@v5
+
+      - name: Test compute features
+        run: uvx nox -s disassemble --verbose
+
+  pass:
+    needs: [pre-commit, check-lite, check-full, discheck]
+    runs-on: ubuntu-latest
+    steps:
+      - run: echo "All jobs passed"
+
+  # root:
+  #   runs-on: ubuntu-latest
+  #   steps:
+  #   - uses: actions/checkout@v4
+
+  #   - name: Get Conda
+  #     uses: conda-incubator/setup-miniconda@v2
+  #     with:
+  #       environment-file: environment.yml
+  #       activate-environment: vector
+
+  #   - name: Run tests
+  #     shell: "bash -l {0}"
+  #     run: python -m pytest tests/root_tests -ra

{vector-1.3.0 → vector-1.6.0}/.github/workflows/notebooks.yml

@@ -11,12 +11,14 @@ concurrency:
   group: ${{ github.workflow }}-${{ github.ref }}
   cancel-in-progress: true
 
+env:
+  # The "FORCE_COLOR" variable, when set to 1,
+  # tells Nox to colorize itself.
+  FORCE_COLOR: "1"
+
 jobs:
   test:
     runs-on: ubuntu-latest
-    strategy:
-      matrix:
-        python-version: ["3.10"]
 
     steps:
       - uses: actions/checkout@v4
@@ -24,18 +26,10 @@ jobs:
       - name: Set up Python
         uses: actions/setup-python@v5
         with:
-          python-version: ${{ matrix.python-version }}
-
-      - name: Install dependencies
-        run: |
-          python -m pip install --upgrade pip setuptools wheel
-          python -m pip install --upgrade .[dev]
-          python -m pip install numba uproot
-          python -m pip install jupyter papermill
+          python-version: "3.10"
 
       - name: List installed Python packages
         run: python -m pip list
 
       - name: Test example notebooks
-        run: |
-          pytest tests/test_notebooks.py
+        run: pipx run nox -s notebooks

{vector-1.3.0 → vector-1.6.0}/.pre-commit-config.yaml

@@ -4,7 +4,7 @@ ci:
 
 repos:
   - repo: https://github.com/pre-commit/pre-commit-hooks
-    rev: v4.5.0
+    rev: v5.0.0
     hooks:
       - id: check-added-large-files
       - id: check-case-conflict
@@ -19,19 +19,14 @@ repos:
       - id: trailing-whitespace
 
   - repo: https://github.com/astral-sh/ruff-pre-commit
-    rev: "v0.2.2"
+    rev: "v0.9.1"
     hooks:
       - id: ruff
         args: ["--fix", "--show-fixes"]
       - id: ruff-format
 
-  - repo: https://github.com/tox-dev/pyproject-fmt
-    rev: "1.7.0"
-    hooks:
-      - id: pyproject-fmt
-
   - repo: https://github.com/pre-commit/mirrors-mypy
-    rev: v1.8.0
+    rev: v1.14.1
     hooks:
       - id: mypy
         files: src
@@ -39,25 +34,27 @@ repos:
         additional_dependencies:
           - numpy
           - packaging
+          - sympy
 
   - repo: https://github.com/codespell-project/codespell
-    rev: v2.2.6
+    rev: v2.3.0
     hooks:
       - id: codespell
+        exclude: ^docs/usage/intro.ipynb$
 
-  - repo: https://github.com/pre-commit/mirrors-prettier
-    rev: "v4.0.0-alpha.8"
+  - repo: https://github.com/rbubley/mirrors-prettier
+    rev: "v3.4.2"
     hooks:
       - id: prettier
         types_or: [yaml, markdown, html, css, scss, javascript, json]
         exclude: assets/js/webapp\.js
 
   - repo: https://github.com/adamchainz/blacken-docs
-    rev: 1.16.0
+    rev: 1.19.1
     hooks:
       - id: blacken-docs
         args: ["-E"]
-        additional_dependencies: [black==23.1.0]
+        additional_dependencies: [black~=24.0]
 
   - repo: https://github.com/pre-commit/pygrep-hooks
     rev: v1.10.0
@@ -67,11 +64,3 @@ repos:
       - id: rst-backticks
       - id: rst-directive-colons
       - id: rst-inline-touching-normal
-
-  - repo: https://github.com/nbQA-dev/nbQA
-    rev: 1.7.1
-    hooks:
-      - id: nbqa-pyupgrade
-        args: ["--py37-plus"]
-      - id: nbqa-isort
-        args: ["--float-to-top"]

vector-1.6.0/PKG-INFO

@@ -0,0 +1,253 @@
+Metadata-Version: 2.4
+Name: vector
+Version: 1.6.0
+Summary: Vector classes and utilities
+Project-URL: Bug Tracker, https://github.com/scikit-hep/vector/issues
+Project-URL: Changelog, https://vector.readthedocs.io/en/latest/changelog.html
+Project-URL: Discussions, https://github.com/scikit-hep/vector/discussions
+Project-URL: Documentation, https://vector.readthedocs.io/
+Project-URL: Homepage, https://github.com/scikit-hep/vector
+Author-email: "Jim Pivarski, Henry Schreiner, Eduardo Rodrigues" <eduardo.rodrigues@cern.ch>
+Maintainer-email: The Scikit-HEP admins <scikit-hep-admins@googlegroups.com>
+License-File: LICENSE
+Keywords: vector
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: Science/Research
+Classifier: License :: OSI Approved :: BSD License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Scientific/Engineering
+Classifier: Topic :: Scientific/Engineering :: Information Analysis
+Classifier: Topic :: Scientific/Engineering :: Mathematics
+Classifier: Topic :: Scientific/Engineering :: Physics
+Classifier: Typing :: Typed
+Requires-Python: >=3.8
+Requires-Dist: numpy>=1.13.3
+Requires-Dist: packaging>=19
+Provides-Extra: awkward
+Requires-Dist: awkward>=2; extra == 'awkward'
+Provides-Extra: dev
+Requires-Dist: awkward>=2; extra == 'dev'
+Requires-Dist: dask-awkward; extra == 'dev'
+Requires-Dist: nox; extra == 'dev'
+Requires-Dist: numba>=0.57; (python_version < '3.13') and extra == 'dev'
+Requires-Dist: papermill>=2.4; extra == 'dev'
+Requires-Dist: pytest-cov>=3; extra == 'dev'
+Requires-Dist: pytest-doctestplus; extra == 'dev'
+Requires-Dist: pytest>=6; extra == 'dev'
+Requires-Dist: sympy; extra == 'dev'
+Provides-Extra: docs
+Requires-Dist: awkward>=2; extra == 'docs'
+Requires-Dist: ipykernel; extra == 'docs'
+Requires-Dist: myst-parser>0.13; extra == 'docs'
+Requires-Dist: nbsphinx; extra == 'docs'
+Requires-Dist: sphinx-book-theme>=0.0.42; extra == 'docs'
+Requires-Dist: sphinx-copybutton; extra == 'docs'
+Requires-Dist: sphinx-math-dollar; extra == 'docs'
+Requires-Dist: sphinx>=4; extra == 'docs'
+Requires-Dist: sympy; extra == 'docs'
+Provides-Extra: numba
+Requires-Dist: numba>=0.57; (python_version < '3.13') and extra == 'numba'
+Provides-Extra: sympy
+Requires-Dist: sympy; extra == 'sympy'
+Provides-Extra: test
+Requires-Dist: nox; extra == 'test'
+Requires-Dist: papermill>=2.4; extra == 'test'
+Requires-Dist: pytest-cov>=3; extra == 'test'
+Requires-Dist: pytest-doctestplus; extra == 'test'
+Requires-Dist: pytest>=6; extra == 'test'
+Provides-Extra: test-extras
+Requires-Dist: dask-awkward; extra == 'test-extras'
+Requires-Dist: spark-parser; extra == 'test-extras'
+Requires-Dist: uncompyle6; (python_version == '3.8') and extra == 'test-extras'
+Description-Content-Type: text/markdown
+
+<img alt="Vector logo" width="50%" src="https://raw.githubusercontent.com/scikit-hep/vector/main/docs/_images/LogoSrc.svg"/>
+
+# Vector: arrays of 2D, 3D, and Lorentz vectors
+
+[![Actions Status][actions-badge]][actions-link]
+[![Documentation Status][rtd-badge]][rtd-link]
+[![pre-commit.ci status][pre-commit-badge]][pre-commit-link]
+[![codecov percentage][codecov-badge]][codecov-link]
+[![GitHub Discussion][github-discussions-badge]][github-discussions-link]
+[![Gitter][gitter-badge]][gitter-link]
+
+[![PyPI platforms][pypi-platforms]][pypi-link]
+[![PyPI version][pypi-version]][pypi-link]
+[![Conda latest release][conda-version]][conda-link]
+[![DOI][zenodo-badge]][zenodo-link]
+[![LICENSE][license-badge]][license-link]
+[![Scikit-HEP][sk-badge]][sk-link]
+
+## Installation
+
+You can install Vector with [pip](https://pypi.org/project/vector/) and [conda](https://anaconda.org/conda-forge/vector).
+
+```bash
+pip install vector
+```
+
+## Introduction
+
+Vector is a Python library for 2D and 3D spatial vectors, as well as 4D space-time vectors. It is especially intended for performing geometric calculations on _arrays of vectors_, rather than one vector at a time in a Python for loop.
+
+Vector is part of the [Scikit-HEP project](https://scikit-hep.org/), High Energy Physics (HEP) tools in Python.
+
+### Coordinate systems
+
+Vectors may be expressed in any of these coordinate systems:
+
+- the azimuthal plane may be Cartesian `x` `y` or polar `rho` ($\rho$) `phi` ($\phi$)
+- the longitudinal axis may be Cartesian `z`, polar `theta` ($\theta$), or pseudorapidity `eta` ($\eta$)
+- the temporal component for space-time vectors may be Cartesian `t` or proper time `tau` ($\tau$)
+
+in any combination. (That is, 4D vectors have 2×3×2 = 12 distinct coordinate systems.)
+
+<img alt="Diagram of coordinate systems" width="100%" src="https://raw.githubusercontent.com/scikit-hep/vector/main/docs/_images/coordinate-systems.svg"/>
+
+### Backends
+
+Vectors may be included in any of these data types:
+
+- [vector.obj](https://vector.readthedocs.io/en/latest/src/make_object.html) objects (pure Python)
+- [NumPy structured arrays](https://numpy.org/doc/stable/user/basics.rec.html) of vectors
+- [Awkward Arrays](https://awkward-array.org/) of vectors (possibly within variable-length lists or nested record structures)
+- [SymPy expressions](https://www.sympy.org/en/index.html) for symbolic (non-numeric) manipulations
+- In [Numba-compiled functions](https://numba.pydata.org/), with [vector.obj](https://vector.readthedocs.io/en/latest/src/make_object.html) objects or Awkward Arrays
+
+Each of these "backends" provides the same suite of properties and methods, through a common "compute" library.
+
+### Geometric versus momentum
+
+Finally, vectors come in two flavors:
+
+- geometric: only one name for each property or method
+- momentum: same property or method can be accessed with several synonyms, such as `pt` ($p_T$, transverse momentum) for the azimuthal magnitude `rho` ($\rho$) and `energy` and `mass` for the Cartesian time `t` and proper time `tau` ($\tau$).
+
+### Familiar conventions
+
+Names and coordinate conventions were chosen to align with [ROOT](https://root.cern/)'s [TLorentzVector](https://root.cern.ch/doc/master/classTLorentzVector.html) and [Math::LorentzVector](https://root.cern.ch/doc/master/classROOT_1_1Math_1_1LorentzVector.html), as well as [scikit-hep/math](https://github.com/scikit-hep/scikit-hep/tree/master/skhep/math), [uproot-methods TLorentzVector](https://github.com/scikit-hep/uproot3-methods/blob/master/uproot3_methods/classes/TLorentzVector.py), [henryiii/hepvector](https://github.com/henryiii/hepvector), and [coffea.nanoevents.methods.vector](https://coffea-hep.readthedocs.io/en/latest/modules/coffea.nanoevents.methods.vector.html).
+
+## Getting help
+
+- Source code on GitHub: [scikit-hep/vector](https://github.com/scikit-hep/vector)
+- Report bugs and request features on the [GitHub Issues page](https://github.com/scikit-hep/vector/issues)
+- Ask questions on the [GitHub Discussions page](https://github.com/scikit-hep/vector/discussions)
+- Real-time chat on Gitter: [Scikit-HEP/Vector](https://gitter.im/Scikit-HEP/vector)
+
+## Contributing to Vector
+
+If you want to contribute to Vector, [pull requests](https://github.com/scikit-hep/vector/pulls) are welcome!
+
+Please install the latest version of the `main` branch from source or a fork:
+
+```bash
+git clone https://github.com/scikit-hep/vector.git
+cd vector
+pip install -e .
+```
+
+Refer to [CONTRIBUTING.md](https://github.com/scikit-hep/vector/blob/main/.github/CONTRIBUTING.md) for more.
+
+## Documentation
+
+### Tutorials
+
+- [Vector objects](https://vector.readthedocs.io/en/latest/src/object.html)
+- [NumPy arrays of vectors](https://vector.readthedocs.io/en/latest/src/numpy.html)
+- [Awkward Arrays of vectors](https://vector.readthedocs.io/en/latest/src/awkward.html)
+- [Compiling functions on vectors with Numba](https://vector.readthedocs.io/en/latest/src/numba.html)
+- [Vector expressions with SymPy](https://vector.readthedocs.io/en/latest/src/sympy.html)
+
+### Vector constructors
+
+- [Making vector objects](https://vector.readthedocs.io/en/latest/src/make_object.html)
+- [Making NumPy arrays of vectors](https://vector.readthedocs.io/en/latest/src/make_numpy.html)
+- [Making Awkward Arrays of vectors](https://vector.readthedocs.io/en/latest/src/make_awkward.html)
+- [Making SymPy vector expressions](https://vector.readthedocs.io/en/latest/src/make_sympy.html)
+
+### Vector functions
+
+- [Interface for all vectors](https://vector.readthedocs.io/en/latest/src/common.html)
+- [Interface for 2D vectors](https://vector.readthedocs.io/en/latest/src/vector2d.html)
+- [Interface for 3D vectors](https://vector.readthedocs.io/en/latest/src/vector3d.html)
+- [Interface for 4D vectors](https://vector.readthedocs.io/en/latest/src/vector4d.html)
+- [Interface for 2D momentum](https://vector.readthedocs.io/en/latest/src/momentum2d.html)
+- [Interface for 3D momentum](https://vector.readthedocs.io/en/latest/src/momentum3d.html)
+- [Interface for 4D momentum](https://vector.readthedocs.io/en/latest/src/momentum4d.html)
+
+### More ways to learn
+
+- [Presentations about Vector](https://vector.readthedocs.io/en/latest/src/talks.html)
+
+## Contributors
+
+Thanks goes to these wonderful people ([emoji key](https://allcontributors.org/docs/en/emoji-key)):
+
+<!-- ALL-CONTRIBUTORS-LIST:START - Do not remove or modify this section -->
+<!-- prettier-ignore-start -->
+<!-- markdownlint-disable -->
+<table>
+  <tr>
+    <td align="center"><a href="https://github.com/jpivarski"><img src="https://avatars.githubusercontent.com/u/1852447?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Jim Pivarski</b></sub></a><br /><a href="#maintenance-jpivarski" title="Maintenance">🚧</a> <a href="https://github.com/scikit-hep/vector/commits?author=jpivarski" title="Code">💻</a> <a href="https://github.com/scikit-hep/vector/commits?author=jpivarski" title="Documentation">📖</a></td>
+    <td align="center"><a href="https://github.com/henryiii"><img src="https://avatars.githubusercontent.com/u/4616906?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Henry Schreiner</b></sub></a><br /><a href="#maintenance-henryiii" title="Maintenance">🚧</a> <a href="https://github.com/scikit-hep/vector/commits?author=henryiii" title="Code">💻</a> <a href="https://github.com/scikit-hep/vector/commits?author=henryiii" title="Documentation">📖</a></td>
+    <td align="center"><a href="https://github.com/eduardo-rodrigues"><img src="https://avatars.githubusercontent.com/u/5013581?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Eduardo Rodrigues</b></sub></a><br /><a href="#maintenance-eduardo-rodrigues" title="Maintenance">🚧</a> <a href="https://github.com/scikit-hep/vector/commits?author=eduardo-rodrigues" title="Code">💻</a> <a href="https://github.com/scikit-hep/vector/commits?author=eduardo-rodrigues" title="Documentation">📖</a></td>
+    <td align="center"><a href="http://lovelybuggies.com.cn/"><img src="https://avatars.githubusercontent.com/u/29083689?v=4?s=100" width="100px;" alt=""/><br /><sub><b>N!no</b></sub></a><br /><a href="https://github.com/scikit-hep/vector/commits?author=LovelyBuggies" title="Documentation">📖</a></td>
+    <td align="center"><a href="https://github.com/pfackeldey"><img src="https://avatars.githubusercontent.com/u/18463582?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Peter Fackeldey</b></sub></a><br /><a href="https://github.com/scikit-hep/vector/commits?author=pfackeldey" title="Documentation">📖</a></td>
+    <td align="center"><a href="https://github.com/kreczko"><img src="https://avatars.githubusercontent.com/u/1213276?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Luke Kreczko</b></sub></a><br /><a href="https://github.com/scikit-hep/vector/commits?author=kreczko" title="Code">💻</a></td>
+    <td align="center"><a href="https://github.com/nsmith-"><img src="https://avatars.githubusercontent.com/u/6587412?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Nicholas Smith</b></sub></a><br /><a href="#ideas-nsmith-" title="Ideas, Planning, & Feedback">🤔</a></td>
+  </tr>
+  <tr>
+    <td align="center"><a href="https://github.com/mayou36"><img src="https://avatars.githubusercontent.com/u/17454848?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Jonas Eschle</b></sub></a><br /><a href="#ideas-mayou36" title="Ideas, Planning, & Feedback">🤔</a></td>
+  </tr>
+</table>
+
+<!-- markdownlint-restore -->
+<!-- prettier-ignore-end -->
+
+<!-- ALL-CONTRIBUTORS-LIST:END -->
+
+This project follows the
+[all-contributors](https://github.com/all-contributors/all-contributors)
+specification. Contributions of any kind welcome! See
+[CONTRIBUTING.md](./.github/CONTRIBUTING.md) for information on setting up a
+development environment.
+
+## Acknowledgements
+
+This library was primarily developed by Saransh Chopra, Henry Schreiner, Jim Pivarski, Eduardo Rodrigues, and Jonas Eschle.
+
+Support for this work was provided by the National Science Foundation cooperative agreement [OAC-1836650](https://www.nsf.gov/awardsearch/showAward?AWD_ID=1836650) and [PHY-2323298](https://www.nsf.gov/awardsearch/showAward?AWD_ID=2323298) (IRIS-HEP) and [OAC-1450377](https://www.nsf.gov/awardsearch/showAward?AWD_ID=1450377) (DIANA/HEP). Any opinions, findings, conclusions or recommendations expressed in this material are those of the authors and do not necessarily reflect the views of the National Science Foundation.
+
+[actions-badge]: https://github.com/scikit-hep/vector/actions/workflows/ci.yml/badge.svg
+[actions-link]: https://github.com/scikit-hep/vector/actions
+[codecov-badge]: https://codecov.io/gh/scikit-hep/vector/branch/main/graph/badge.svg?token=YBv60ueORQ
+[codecov-link]: https://codecov.io/gh/scikit-hep/vector
+[conda-version]: https://img.shields.io/conda/vn/conda-forge/vector.svg
+[conda-link]: https://github.com/conda-forge/vector-feedstock
+[github-discussions-badge]: https://img.shields.io/static/v1?label=Discussions&message=Ask&color=blue&logo=github
+[github-discussions-link]: https://github.com/scikit-hep/vector/discussions
+[gitter-badge]: https://badges.gitter.im/Scikit-HEP/vector.svg
+[gitter-link]: https://gitter.im/Scikit-HEP/vector?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge
+[license-badge]: https://img.shields.io/badge/License-BSD_3--Clause-blue.svg
+[license-link]: https://opensource.org/licenses/BSD-3-Clause
+[pre-commit-badge]: https://results.pre-commit.ci/badge/github/scikit-hep/vector/main.svg
+[pre-commit-link]: https://results.pre-commit.ci/repo/github/scikit-hep/vector
+[pypi-link]: https://pypi.org/project/vector/
+[pypi-platforms]: https://img.shields.io/pypi/pyversions/vector
+[pypi-version]: https://badge.fury.io/py/vector.svg
+[rtd-badge]: https://readthedocs.org/projects/vector/badge/?version=latest
+[rtd-link]: https://vector.readthedocs.io/en/latest/?badge=latest
+[sk-badge]: https://scikit-hep.org/assets/images/Scikit--HEP-Project-blue.svg
+[sk-link]: https://scikit-hep.org/
+[zenodo-badge]: https://zenodo.org/badge/DOI/10.5281/zenodo.7054478.svg
+[zenodo-link]: https://doi.org/10.5281/zenodo.7054478