AllenInstitute / AllenInstitute/ConnectsCommonConnectivity

wide_parquet mode + combined wide-matrix/pointer write API

Open
#20 0 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

enhancement io
Dominant language
Jupyter Notebook
Stars
4
Forks
1
PR merge metrics
No merged PRs in 30d

Description

Problem: the wide_parquet mode designed in ARCHITECTURE.md was never built; all wide tables are raw write_deltalake calls in notebooks. Nothing enforces that pointer rows (CellFeatureMatrix, SynapseFeatureMatrix) and the parquet they point at are written together — dangling-pointer risk.

Fix: build wide_parquet; add a combined API that writes the payload (overwrite) then merges the pointer row, validating that index columns/paths agree.

Depends on: #13 (mode vocabulary).

Contributor guide

No contributing guide indexed for this repository

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Read ARCHITECTURE.md and the mode vocabulary from #13 first, then inspect the notebooks' raw write_deltalake calls and the CellFeatureMatrix and SynapseFeatureMatrix pointer rows. Done means wide_parquet exists and a combined API writes the payload before merging a validated pointer row, with index columns and paths agreeing.

Written by the indexing model from the issue text.

Assessment

Tech stack
jupyter-notebook
Domain
data
Issue type
Feature
Difficulty
5/5
Estimated time
Over a week
Activity status
Active
Clarity
Mostly clear
Newbie friendliness
35/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.