PFS Quicklook Web App

Web application for quick-look visualization of Prime Focus Spectrograph (PFS) data, designed for summit and remote observers to perform real-time quality assessment during observations.

This app replaces the previous Jupyter notebook-based quicklook tool (check_quick_reduction_data.ipynb) with a production-ready web interface.

Key Features

• Fiber configuration viewer with interactive table and checkbox selection
• Three-way fiber selection: Select fibers via table, OB Code, or Fiber ID widgets
• Interactive 2D/1D spectral visualization with zoom, pan, and hover tools
• Multi-user support with per-session state isolation
• Automatic visit discovery with configurable auto-refresh
• Performance optimizations (parallel processing, intelligent caching)
• Dual deployment modes (development/production)

Prerequisites

• Access to PFSA servers
• Configuration file for Butler database access (contact Moritani-san, Yabe-san, or PFS obsproc team)

Quick Start

# Clone repository
git clone https://github.com/Subaru-SciOp/pfs_quicklook.git
cd pfs_quicklook

# Follow setup guide for detailed installation
# See: docs/setup.md

# Launch application (production mode)
bash ./launch_app.bash

# Access in browser
# http://<your_server_hostname>:5106/quicklook

For detailed installation instructions, see Setup Guide.

Documentation

For Observers

Operating instructions for using the application during observations:

• User Guide - Complete workflow and features
  • Loading Visit Data
  • 2D Spectral Images
  • 1D Spectra Visualization

For Administrators

Installation, configuration, and maintenance:

• Setup Guide - Installation and deployment instructions

For Everyone

• Troubleshooting - Common issues and solutions
• Documentation Index - Complete documentation navigation

For Developers

Technical details and architecture:

• CLAUDE.md - Comprehensive technical documentation
  • Architecture and code organization
  • Performance optimization details
  • Development roadmap

TODO

High Priority

• DetectorMap overlay for fiber trace visualization
• Multi-visit stacking for improved S/N

Medium Priority

• Export functionality (PNG, HTML, FITS)
• Additional visualization options (colormap selection, custom scaling)
• Advanced spectral analysis tools (line identification, measurements)

Contact & Support

This is a QuickLook tool for PFS observatory operations.

For issues or feature requests:

• PFS Observation Helpdesk: pfs-obs-help@naoj.org
• GitHub Issues: https://github.com/Subaru-SciOp/pfs_quicklook/issues
• Review documentation: User Guide | Troubleshooting

License

This software is licensed under the MIT License. See LICENSE for details.

Copyright (c) 2025 Masato Onodera, Subaru/PFS obsproc team

Acknowledgments

Built with Panel, HoloViews, Bokeh, and the LSST Science Pipelines.