{"id":26190817,"url":"https://github.com/boada/astlib","last_synced_at":"2026-04-28T04:02:46.949Z","repository":{"id":24378286,"uuid":"27777848","full_name":"boada/astLib","owner":"boada","description":"My personal development of the astLib library.","archived":false,"fork":false,"pushed_at":"2020-01-10T17:59:31.000Z","size":1965,"stargazers_count":3,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-03-12T00:57:56.125Z","etag":null,"topics":["astronomers","astronomy","astrophysics","python","python-2","python-3","python-modules","wcs"],"latest_commit_sha":null,"homepage":" http://astlib.sourceforge.net","language":"C","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"lgpl-2.1","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/boada.png","metadata":{"files":{"readme":"README","changelog":"CHANGE_LOG","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2014-12-09T17:21:20.000Z","updated_at":"2020-02-21T16:59:04.000Z","dependencies_parsed_at":"2022-07-10T11:00:24.783Z","dependency_job_id":null,"html_url":"https://github.com/boada/astLib","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/boada/astLib","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/boada%2FastLib","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/boada%2FastLib/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/boada%2FastLib/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/boada%2FastLib/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/boada","download_url":"https://codeload.github.com/boada/astLib/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/boada%2FastLib/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32365519,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-27T20:07:02.737Z","status":"online","status_checked_at":"2026-04-28T02:00:07.250Z","response_time":56,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["astronomers","astronomy","astrophysics","python","python-2","python-3","python-modules","wcs"],"created_at":"2025-03-12T00:57:58.707Z","updated_at":"2026-04-28T04:02:46.932Z","avatar_url":"https://github.com/boada.png","language":"C","funding_links":[],"categories":[],"sub_categories":[],"readme":"astLib: python astronomy modules\n\n    version: 0.9.1\n\n    (c) 2007-2012 Matt Hilton\n    (c) 2013-2017 Matt Hilton \u0026 Steven Boada\n\n    http://astlib.sourceforge.net\n\n    email: matt.hilton@mykolab.com\n\n-------------------------------------------------------------------------------------------------------------\nINTRODUCTION\n\nastLib provides some tools for research astronomers who use Python. It is divided into several modules:\n\n    - astCalc   (general calculations, e.g. luminosity distance etc.)\n    - astCoords (coordinate conversions etc.)\n    - astImages (clip sections from .fits etc.) \n    - astPlots  (provides a flexible image plot class, e.g. plot image with catalogue objects overlaid)\n    - astSED    (calculate colours, magnitudes from stellar population models or spectral templates, fit\n                 photometric observations using stellar population models etc.)\n    - astStats  (statistics, e.g. biweight location/scale estimators etc.)\n    - astWCS    (routines for using FITS World Coordinate System information)\n\nThe astWCS module is a higher level interface to PyWCSTools, a simple SWIG (http://www.swig.org) wrapping \nof some of the routines from WCSTools by Jessica Mink (http://tdc-www.harvard.edu/software/wcstools/). It is \nused by some routines in astCoords, astImages and astPlots.\n\nThe goal of astLib is to provide features useful to astronomers that are not included in the scipy \n(http://scipy.org), numpy (http://numpy.scipy.org) or matplotlib (http://matplotlib.sourceforge.net) modules \non which astLib depends. For a more extensive set of python astronomy modules, see astropy \n(http://www.astropy.org/).\n\nSome scripts using astLib can be found in the examples/ folder in this archive.\n\n-------------------------------------------------------------------------------------------------------------\nINSTALLATION\n\nastLib 0.9.0 requires:\n\n    * Python\n      (tested on versions 2.7.3+)\n    * PyFITS - http://www.stsci.edu/resources/software_hardware/pyfits\n      (tested on version 3.4)\n    * numpy - http://numpy.scipy.org\n      (tested on version 1.13.0)\n    * scipy - http://scipy.org\n      (tested on version 0.18.1)\n    * matplotlib - http://matplotlib.sourceforge.net\n      (tested on version 1.5.1)\n\noptional:\n   \n    * Python Imaging Library - http://www.pythonware.com/products/pil\n      (tested on version 1.1.7)\n    * astropy - http://www.astropy.org/\n      (tested on version 1.3)\n      This is currently only used if pyfits is not installed (astropy.io.fits at present provides \n      a drop-in replacement for pyfits).\n\nOther versions of the software listed above are likely to work - I'm unable to test every possible \ncombination. For reference, astLib is currently developed on KDE neon/Ubuntu 16.04 (x86_64). Note that \nit is possible to use some astLib functions (such as the astWCS module) without installing all of the \npython modules listed above.\n    \nTo install astLib system wide (and build and install PyWCSTools), simply:\n\n    % sudo python setup.py install\n\nin the directory this README is in.\n\nIf you do not have root access to your machine, astLib can be installed in your home directory by\ndoing the following:\n\n    % python setup.py install --prefix=$HOME/python-modules\n\nand adding something like the following to your .bashrc (or equivalent):\n    \n    export PYTHONPATH=$PYTHONPATH:$HOME/python-modules/lib/python2.7/site-packages\n\n-------------------------------------------------------------------------------------------------------------\nUSAGE\n\nTo access the routines in the astLib modules, simply:\n\n    % from astLib import astCalc\n    % from astLib import astCoords\n    % from astLib import astWCS\n\netc.\n\nThe astWCS module currently provides access to what are (I think) the most commonly needed WCS information \nand functions (such as converting between pixel and WCS coordinates etc.). However, should you wish to \naccess the wrapped WCSTools routines themselves directly: \n\n    % from PyWCSTools import wcs\n    % from PyWCSTools import wcscon\n\netc.\n\nNote that PyWCSTools only includes some functions from wcs.c and wcscon.c at present. For examples of usage, \nlook at the Python code for the astLib.astWCS module. Documentation for the WCSTools routines can be found \nhere: http://tdc-www.harvard.edu/software/wcstools/subroutines/libwcs.wcs.html.\n\n-------------------------------------------------------------------------------------------------------------\nKNOWN ISSUES\n\nThis may no longer apply, but just in case...\n\nRecent versions of matplotlib (on which astLib depends) now use locale information. On systems where the\ndecimal point separator is not '.' (e.g. Germany), the astWCS coordinate conversions routines will give\nstrange results if this is not accounted for. As of version 0.3.0, the astWCS module will detect if this is \nthe case and print a warning message to the console.\n\nThe workaround for this issue is to add the following after importing any python modules that expicitly set \nthe locale (such as matplotlib):\n    \n    % import locale\n    % locale.setlocale(locale.LC_NUMERIC, 'C')\"\n\nThanks to Markus Demleitner for pointing this out.\n\n-------------------------------------------------------------------------------------------------------------\nDOCUMENTATION\n\nDocumentation is available on the web at:\n\n    http://astlib.sourceforge.net/?q=docs0.7\n\nThe API reference documentation (generated using epydoc) is also supplied in HTML format in this archive \nunder the docs/astLib/ directory.\n\n-------------------------------------------------------------------------------------------------------------\nBUGS\n\nPlease email bug reports to matt.hilton@mykolab.com, or alternatively use the bug tracker:\n    \n    http://sourceforge.net/p/astlib/bugs/\n\nPlease include details of your operating system, python version, and versions of the python packages \nrequired by astLib that you have installed on your machine. For any WCS-related bugs, it would be helpful \nif you could also include the image header as a text file so that I can reproduce them easily. \n\n-------------------------------------------------------------------------------------------------------------\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fboada%2Fastlib","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fboada%2Fastlib","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fboada%2Fastlib/lists"}