mcp-stargazing logo

mcp-stargazing

by StarGazer1995

Calculate the altitude, rise, and set times of celestial objects for any location on Earth. It also offers optional light pollution analysis.

View on GitHub

Last updated: N/A

What is mcp-stargazing?

mcp-stargazing is a Python package that allows users to calculate the position (altitude and azimuth), rise, and set times of celestial objects, including the Sun, Moon, planets, stars, and deep-space objects. It also provides functionality to load and analyze light pollution maps.

How to use mcp-stargazing?

To use mcp-stargazing, install the required dependencies using pip install astropy pytz numpy astroquery rasterio geopy. Then, use the provided functions in src/celestial.py to calculate celestial positions and rise/set times. The src/light_pollution.py module can be used to load and analyze light pollution maps. Example usage is provided in the README.

Key features of mcp-stargazing

  • Altitude/Azimuth Calculation

  • Rise/Set Times Calculation

  • Light Pollution Analysis

  • Supports Solar system objects, Stars, and Deep-space objects

  • Time Zone Aware

Use cases of mcp-stargazing

  • Planning stargazing sessions

  • Determining optimal times for astronomical observations

  • Analyzing the impact of light pollution on visibility

  • Educational tool for learning about celestial mechanics

  • Developing astronomy-related applications

FAQ from mcp-stargazing

What celestial objects are supported?

The package supports solar system objects (Sun, Moon, planets), stars, and deep-space objects.

How do I specify the location of the observer?

Use the EarthLocation object from the astropy.coordinates module to define the observer's latitude and longitude.

How do I handle time zones?

Use timezone-aware datetime objects from the pytz library or Astropy Time objects.

What format are the light pollution maps in?

Light pollution maps should be in GeoTIFF format.

How can I run the tests?

Run the tests using pytest tests/.