panoseti-orientation

name	panoseti-orientation
description	Use when starting any task in the panoseti observatory codebase and unsure where code, tests, or reference docs live, or which subsystem (control, grpc, daq, analysis) or which CLAUDE.md / wiki page applies.

PanoSETI Codebase Orientation

Overview

PanoSETI is a multi-node observatory control and data-acquisition system. The repo is divided into Python-heavy subsystems with their own CLAUDE.md files and a shared wiki_docs/ GitHub wiki mirror.

When NOT to use

If you already know which subsystem you're in, skip this skill and load the relevant topic skill directly from the table below.

Repo map

Dir	Contents
control/	Observatory control plane: pseti CLI, run lifecycle, config, daemons, hardware drivers
grpc/	Git submodule → panoseti_grpc: daq_data, daq_control, telemetry gRPC services
pypff/	High-performance PFF file reader (mmap + NumPy); pypff package
daq/	Git submodule → Hashpipe DAQ pipeline (C/C++)
analysis/	Data analysis framework
util/	Shared C++ utilities: pff.cpp (PFF writer/reader), image processing
wiki_docs/	GitHub wiki mirror — markdown reference docs (read-only authoritative)
alloy/	Grafana Alloy config + Docker Compose for Loki log shipping

CLAUDE.md files and their scope

File	Owns
CLAUDE.md (root)	Hardware topology, config system, observing run flow, PFF format, timing, gRPC service overview
control/CLAUDE.md	Transaction/lock model, Pydantic conventions, test tiers, telemetry logger
grpc/CLAUDE.md	gRPC architecture, service internals, testing infra, key gotchas
grpc/GEMINI.md	Engineering standards, concurrency rules, coding style
pypff/CLAUDE.md	pypff package internals

wiki_docs/ domains

wiki_docs/ is the GitHub wiki mirror (~50 .md files). Search it by keyword; the files are named after topics. Key domain groupings:

Domain	Topics covered
Hashpipe / DAQ	Hashpipe overview, data-recorder threads, DAQ-system-overview, building hashpipe, test data
Config / setup	Configuration-files, Sessions-and-configuration, network-configuration, node setup, storage
Data format	Data-file-format, Data-file-names, Data-types, Metadata, Pixel-indexing
Hardware / Quabo	Quabo-packet-interface, Quabo-device-driver, Nodes-and-modules, TFTP, power control
Observing / timing	Observing-runs, Precise-Timing, Interleaving, White-Rabbit-*
Analysis	Analysis-framework, Pulse-finding-*
Control system	Control-system-implementation, Web-summary

Load one of these skills next

Task	Skill
Running or scripting pseti commands / observing lifecycle	using-pseti-cli
Running, writing, or debugging tests / CI	testing-panoseti
Modifying gRPC services or adding a new one	developing-grpc-services
Modifying control/ code (transactions, config, daemons)	developing-control-code
Sending UDP commands to Quabo boards / MAROC / HV	working-with-quabo-driver
Reading, parsing, or converting PFF data files	working-with-pff-data