Skip to main content

nested-pandas

Template

PyPI Conda

GitHub Workflow Status codecov Read the Docs benchmarks

An extension of pandas for efficient representation of nested associated datasets.

Nested-Pandas extends the pandas package with tooling and support for nested dataframes packed into values of top-level dataframe columns. Pyarrow is used internally to aid in scalability and performance.

nested-pandas API

Nested-Pandas allows data like this:

pandas dataframes

To instead be represented like this:

nestedframe

Where the nested data is represented as nested dataframes:

   # Each row of "object_nf" now has it's own sub-dataframe of matched rows from "source_df"
   object_nf.loc[0]["nested_sources"]

sub-dataframe

Allowing powerful and straightforward operations, like:

   # Compute the mean flux for each row of "object_nf"
   import numpy as np

   def mean_flux(row):
   """Calculates the mean flux for each object"""
       return np.mean(row["nested_sources.flux"])

   object_nf.map_rows(mean_flux, output_names="mean_flux")

using map_rows

Nested-Pandas is motivated by time-domain astronomy use cases, where we see typically two levels of information, information about astronomical objects and then an associated set of N measurements of those objects. Nested-Pandas offers a performant and memory-efficient package for working with these types of datasets.

Core advantages being:

  • hierarchical column access
  • efficient packing of nested information into inputs to custom user functions
  • avoiding costly groupby operations

This is a LINCC Frameworks project - find more information about LINCC Frameworks here.

Acknowledgements

This project is supported by Schmidt Sciences.

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

nested_pandas-0.7.0.tar.gz (1.2 MB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

nested_pandas-0.7.0-py3-none-any.whl (81.0 kB view details)

Uploaded Python 3

File details

Details for the file nested_pandas-0.7.0.tar.gz.

File metadata

  • Download URL: nested_pandas-0.7.0.tar.gz
  • Upload date:
  • Size: 1.2 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for nested_pandas-0.7.0.tar.gz
Algorithm Hash digest
SHA256 4383441bc757bf53b6db6d7d576e3494565ccada6493b6bee6b237ded9ccb770
MD5 e480463876f12196c42475a10781bd02
BLAKE2b-256 9d03d00a1d067024364d7493dedc30cf82c8efda18f1a4340f2645e40905cb17

See more details on using hashes here.

Provenance

The following attestation bundles were made for nested_pandas-0.7.0.tar.gz:

Publisher: publish-to-pypi.yml on lincc-frameworks/nested-pandas

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file nested_pandas-0.7.0-py3-none-any.whl.

File metadata

  • Download URL: nested_pandas-0.7.0-py3-none-any.whl
  • Upload date:
  • Size: 81.0 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for nested_pandas-0.7.0-py3-none-any.whl
Algorithm Hash digest
SHA256 910f6fe425e879e68c529654608cda6bbd19c66873df3f9e376a12f4f74bfd46
MD5 bfa5be4852aa54289c7fc862977722c4
BLAKE2b-256 a1b61e2ab0cb518d64038fca6b30553219f4b113e910286eabe22aa28c4a1d8a

See more details on using hashes here.

Provenance

The following attestation bundles were made for nested_pandas-0.7.0-py3-none-any.whl:

Publisher: publish-to-pypi.yml on lincc-frameworks/nested-pandas

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page