AstroQ:
Schedule Astronomical Observations

Welcome to AstroQ’s documentation! AstroQ is a Python package designed to solve an optimal scheduling for thousands of observations, subject to a variety of constraints.

Please cite the following papers if you use AstroQ in your to plan your observations:

• Lubin et al. (2025)

• Handley et al. (2024a)

Contents:

• Getting Started
  • Installation
  • Required Files
  • Command Line Interface
  • Hello World Example
• OB Construction
• Modules
  • access
  • benchmarking
  • kpfcc.py
  • cli.py
  • driver.py
  • history
  • io
  • nplan
  • plot.py
  • splan
  • webapp
• cli.py
  • main()
• driver.py
  • bench()
  • kpfcc_prep()
  • kpfcc_webapp()
  • plan_night()
  • plan_semester()
  • plot()
  • requests_vs_schedule()
• kpfcc.py
  • Access_KPFCC
  • _validate_datetime_format()
  • analyze_bad_obs()
  • apply_safety_valves()
  • cast_columns()
  • compute_exposure_info()
  • create_checks_dataframes()
  • filter_request_csv()
  • flatten()
  • format_custom_csv()
  • format_keck_allocation_info()
  • format_kpf_row()
  • get_request_sheet()
  • inspect_row()
  • load_fit_results_h5()
  • plot_bad_obs_histograms()
  • pm_correcter()
  • pull_OB_histories()
  • pull_OBs()
  • pull_allocation_info()
  • recompute_exposure_times()
  • sort_good_bad()
  • update_allocation_file()
  • validate_and_convert_coordinates()
  • write_starlist()
• plot.py
  • StarPlotter
  • add_star_links()
  • compute_seasonality()
  • createTelSlewPath()
  • dataframe_to_html()
  • get_birdseye()
  • get_cof()
  • get_football()
  • get_ladder()
  • get_rawobs()
  • get_request_frame()
  • get_script_plan()
  • get_slew_animation_plotly()
  • get_tau_inter_line()
  • get_timebar()
  • get_timebar_by_program()
  • nightplan_table_to_html()
  • past_history_table()
  • plot_path_2D_interactive()
  • process_stars()
  • request_frame_to_html()

Indices and tables

• Index

• Module Index

• Search Page