https://github.com/b612-asteroid-institute/mpc_obscodes

Minor Planet Center's Observatory Codes
https://github.com/b612-asteroid-institute/mpc_obscodes

data-package

Last synced: 5 months ago
JSON representation

Minor Planet Center's Observatory Codes

• Host: GitHub
• URL: https://github.com/b612-asteroid-institute/mpc_obscodes
• Owner: B612-Asteroid-Institute
• License: mit
• Created: 2023-02-25T01:51:31.000Z (over 3 years ago)
• Default Branch: main
• Last Pushed: 2025-04-22T15:36:10.000Z (about 1 year ago)
• Last Synced: 2025-09-09T13:37:06.897Z (9 months ago)
• Topics: data-package
• Language: Python
• Homepage:
• Size: 25.4 KB
• Stars: 1
• Watchers: 3
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          
# mpc_obscodes: Minor Planet Center Observatory Codes File

#### A Python package by the Asteroid Institute, a program of the B612 Foundation

[![Python 3.7+](https://img.shields.io/badge/Python-3.7%2B-blue)](https://img.shields.io/badge/Python-3.7%2B-blue)

[![PyPI version](https://img.shields.io/pypi/v/mpc-obscodes)](https://img.shields.io/pypi/v/mpc-obscodes)

[![PyPi downloads](https://img.shields.io/pypi/dm/mpc-obscodes)](https://img.shields.io/pypi/dm/mpc-obscodes)  

[![Build and Test](https://github.com/B612-Asteroid-Institute/mpc_obscodes/actions/workflows/build_test.yml/badge.svg)](https://github.com/B612-Asteroid-Institute/mpc_obscodes/actions/workflows/build_test.yml)

[![Build, Test, & Publish](https://github.com/B612-Asteroid-Institute/mpc_obscodes/actions/workflows/build_test_publish.yml/badge.svg)](https://github.com/B612-Asteroid-Institute/mpc_obscodes/actions/workflows/build_test_publish.yml)

[![Compare Upstream](https://github.com/B612-Asteroid-Institute/mpc_obscodes/actions/workflows/compare_upstream.yml/badge.svg)](https://github.com/B612-Asteroid-Institute/mpc_obscodes/actions/workflows/compare_upstream.yml)  

This package ships the Minor Planet Center's [file](https://minorplanetcenter.net/Extended_Files/obscodes_extended.json.gz) of observatory codes and their geodetic coordinates.

**This is not an official MPC package**. It is an automatically generated mirror of the file so that it is

installable via `pip`.

Every night at around 2:15 AM UTC, the MPC observatory code file is downloaded and compared (via md5 checksum) to the current version of this package. If the checksums are different, a new package will be published.

## Installation

The latest version of the file can be install via pip:  

`pip install mpc-obscodes`

## Usage

```python

import pandas as pd

from mpc_obscodes import mpc_obscodes

obscodes = pd.read_json(mpc_obscodes, orient="index")

```

## Acknowledgment

This research has made use of data and/or services provided by the International Astronomical Union's Minor Planet Center.

See the Minor Planet Center's [website](https://cgi.minorplanetcenter.net/) for more details.