lincc-frameworks / lincc-frameworks/nested-pandas

Create visualizations for presentations

Open
#485 0 comments 0 reactions 0 assignees View on GitHub
Dominant language
Python
Stars
26
Forks
8
Avg merge
2d 2h
Merged PRs (30d)
9

Description

Create a set of static figures illustrating nested-pandas' data model and scientific usage patterns. These should be added to the [project's presentation deck ](https://docs.google.com/presentation/d/1Z5B6A69BUBUc4vRz1qncC4ygaj98aMJiRiQFgvzh8tI/) to be used for the presentation to the broad astronomical community.

The goal is to have figures that convey what nested-pandas does and why it matters, so that astronomers familiar with large-scale data analysis can quickly grasp the value and consider adopting it in their workflows.

### Suggested figures (some of these already avaliable at various locations):

#### Data Model Figures
- [ ] **Nested structure diagram** — visual comparison of flat vs. nested
DataFrame layout (e.g., per-object metadata + per-observation time
series in a single structure)
- [ ] **Schema diagram** — how a NestedFrame maps to a nested column,
showing dtypes and nesting levels

#### Usage / Workflow Figures
- [ ] **End-to-end workflow** — schematic of ingesting catalog with time-series
data, querying, and extracting results using nested-pandas API
- [ ] **Code + output side-by-side** — a short representative code snippet
alongside its resulting NestedFrame output (table or diagram)

#### Performance / Scale Figure
- [ ] **Performance comparison** — benchmark plot comparing nested-pandas
to a naive flat-table approach on a realistic astronomical dataset
(e.g., object catalog with light curves)

### Acceptance Criteria
- [ ] Each figure is self-contained and readable at conference-slide scale
(no microscopic labels)
- [ ] Figures use consistent styling (color palette, fonts) suitable for
a light-background slide deck
- [ ] Exported as high-resolution PNG or SVG
- [ ] Figures added to the shared [Google Slides deck](https://docs.google.com/presentation/d/1Z5B6A69BUBUc4vRz1qncC4ygaj98aMJiRiQFgvzh8tI/)

Contributor guide

No contributing guide indexed for this repository

Research direction

Review the linked Google Slides deck, the nested-pandas API, and the suggested existing figure locations before planning the set of visuals. Done means the figures explain the data model and usage patterns, remain readable and consistently styled at slide scale, are exported as PNG or SVG, and are added to the shared deck.

Written by the indexing model from the issue text.

Assessment

Tech stack
pandas, python
Domain
data-visualization, documentation
Issue type
Documentation
Difficulty
5/5
Estimated time
Over a week
Activity status
Quiet
Clarity
Mostly clear
Newbie friendliness
45/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.