astropenguin / azely

:zap: Computation and plotting of azimuth and elevation for astronomical objects

🐧 Who am I?

• Name: Akio Taniguchi (谷口 暁星)
• Job: Project assistant professor (LMT-FINER) at Nagoya University, Japan
• Interests: Data-scientific approaches to development of astronomical instruments

🔎 Featured publication

• Data science based efficient and automated spectroscopy for submillimeter single-dish telescopes (Taniguchi et al. 2023, URSI GASS 2023)
• DESHIMA 2.0: development of an integrated superconducting spectrometer for science-grade astronomical observations (Taniguchi et al. 2022, The Journal of Low Temperature Physics)
• Application of data science to radio spectroscopic imaging observations (Taniguchi 2022, The Astronomical Herald)
• A data-scientific noise-removal method for efficient submillimeter spectroscopy with single-dish telescopes (Taniguchi et al. 2021, The Astronomical Journal)
• A new off-point-less observing method for millimeter and submillimeter spectroscopy with a frequency-modulating local oscillator (Taniguchi et al. 2020, Publications of the Astronomical Society of Japan)
• First light demonstration of the integrated superconducting spectrometer (A. Endo, K. Karatsu, Y. Tamura, T. Oshima, A. Taniguchi et al. 2019, Nature Astronomy)

azely's Issues

Update Flake8 config

• Use minimum Flake8 config (.flake8)
• Update codes to be compatible with the new config

Fix example codes in README

Update query format of location and object modules

Fix index name of in_utc

Fix wrong index name of a DataFrame with the in_utc property.

Add custom properties to pandas DataFrame

Add properties (i.e., object's name) to an output DataFrame of compute() using Extending pandas

Update time module

Add docstring and documentation

• Add docstring to functions
• Make documentation using sphinx

Update cache feature

Add feature of multiple objects

Add a utility function to parse queries of objects to an iterable. For example, the proposed function lists names of Messier objects in user.toml and all names in solar.toml:

for obj in func(['user:^M[0-9]+$', 'solar:*']):
    print(obj)

user:M1
user:M2
...
solar:Sun
solar:Moon
...

Then update the compute() function like:

for df in azely.compute(['user:^M[0-9]+$', 'solar:*'], 'Tokyo', ...):
    df.el.plot(ylim=(0, 90))

Note that the utility function must only be activated when obj is given as a list or a tuple and the return be a generator; otherwise obj is never parsed even if it is regex-like (i.e., with obj='solar:*', it tries to find an object whose names is * in user.toml).

Update force-query feature

Use query='aaa!' instead of query='!aaa' to forcibly update information of an object or a location.

• Update the cache_to decorator and get_* functions
• Update related description in docstrings and README

Release v0.7.0

Add feature to get user-defined object/location

Update docs

Update (or fix) the following docs.

• Add description of default values in the azel module and the compute() function
• Add example images of codes in README

Update supported Python versions

• Drop Python 3.6 support
• Add Python 3.9-3.10 support

Add plotting functions

Update reading and writing methods of TOML

Release v0.6.0

• Update version numbers written in:
  • pyproject.toml
  • azely/__init__.py
  • docs/conf.py
  • tests/test_metadata.py
• Remove docs/images/example.png
• Update image URLs in README
  • use .../v0.6.0/docs/_static/*.svg instead of .../master/docs/_static/*.svg

Use case-insensitive query

Make sure that 'query', 'QUERY', and 'QuErY' are considered to be same.
Note that other parameters are still case-sensitive at this moment:
For example, frame='ICRS' is not allowed.

Update customizing method of default values

Specification change about Google Maps APIs

Google Maps APIs cannot be used without an API key since July 2018 and azely outputs an error when it requests the location information from Google Maps.

Update query format of location and object modules

Use Astropy's EarthLocation.of_address to get location

Update location module

• Use astropy.coordinates.Longitude and astropy.coordinates.Latitude classes to parse strings of coordinates in the Azely's Location class.
• Use the official ipinfo package for getting current location

Use today as a default value of time

• Use time='today' as a default value of azely.compute() and azely.time.get_time()
• Update docstrings that describe default time value
• Update README

Update supported Python versions

• Drop support for Python 3.7
• Add support for Python 3.11

Add custom properties to pandas DataFrame

Add properties (i.e., object's name) to an output DataFrame of compute() using Extending pandas

Update cache method

Add command line interface

Remove format feature

Update time module

Add option for forcibly updating cache

Implement an option for forcibly updating cache
when query string is given with the special keyword (!).

import azely

# not updated (if cached value already exists)
location = azely.get_location("here")

# forcibly updated
location = azely.get_location("!here")

Update supported Python versions

Update object module

Add CONTRIBUTING.md

• Add CONTRIBUTING.md to .github
• Move CODE_OF_CONDUCT.md to .github

Add async feature to query functions

Add or update functions which are compatible with Python async

Update develop environment

• Update workflow scripts
• Update scripts in etc