Skip to content

JuliaAstro/SkyCoords.jl

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

29 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

SkyCoords.jl

Basic astronomical coordinate systems in Julia

Build Status Coverage Status

Install

julia> Pkg.add("SkyCoords")

Usage

There are currently three supported coordinate systems. The following immutable types are used to represent coordinates in each system:

  • ICRSCoords: ICRS coordinates system
  • GalCoords: Galactic coordinates system
  • FK5Coords: FK5 coordinates system (with arbitrary equninox)

Each type holds a longitude and latitude, and each is a subtype of AbstractSkyCoords.

julia> using SkyCoords

# create a coordinates object
julia> c1 = ICRSCoords(0., 0.)  # inputs are ra, dec in radians
ICRSCoords(0.0,0.0)

# access ra, dec individually
julia> c1.ra
0.0

# convert to a different system
julia> c2 = convert(GalCoords, c1)
GalCoords(1.681404315278054,-1.0504869904089078)

# Note that galactic coordinate fields are l, b
julia> c2.l
1.681404315278054

# FK5Coords is parameterized on equinox.
# Equinox refers to Julian year and can be floating-point or integer
# (though using integers seems to be slightly faster).
julia> convert(FK5Coords{2000}, c1)
FK5Coords{2000}(1.1102233710147402e-7,4.411803426976326e-8)

# Arrays of coordinates
# =====================

# create an array of coordinates 
julia> c1 = [ICRSCoords(0., 0.) for i=1:3]
3-element Array{ICRSCoords,1}:
 ICRSCoords(0.0,0.0)
 ICRSCoords(0.0,0.0)
 ICRSCoords(0.0,0.0)

# convert entire array to a different system
julia> convert(Vector{GalCoords}, c1)
3-element Array{GalCoords,1}:
 GalCoords(1.681404315278054,-1.0504869904089078)
 GalCoords(1.681404315278054,-1.0504869904089078)
 GalCoords(1.681404315278054,-1.0504869904089078)

# There's no performance gain from using this "vectorized" convert,
# except conversions to/from FK5Coords, where the equinox precession
# can be done just once for the entire vector, leading to a modest ~2x
# speed up.
julia> convert(Vector{FK5Coords{1975}}, c1)
3-element Array{FK5Coords{1975},1}:
 FK5Coords{1975}(6.277595732508468,-0.0024292220493946897)
 FK5Coords{1975}(6.277595732508468,-0.0024292220493946897)
 FK5Coords{1975}(6.277595732508468,-0.0024292220493946897)

Accuracy

All the supported conversions have been compared to the results of astropy.coordinates (to better than 0.0001 arcsec agreement). In turn, astropy.coordinates has been tested against many other tools.

Performance

For small and moderate numbers of coordinates, conversions are much faster than astropy.coordinates in Python. The follow plot shows the performance for converting ICRS coordinates to various other systems (Galactic, FK5J2000 and FK5J1975), using astropy.coordinates (py_* labels) and SkyCoords.jl (jl_* labels). The x axis denotes the number of coordinates being simultaneously converted, with 1 corresponding to scalar coordinates.

times

For scalar coordinates, SkyCoords.jl is up to 100,000 times faster. For very large vectors of one million coordinates or more, SkyCoords.jl is 2-4 times faster. The source code for these benchmarks can be found in bench/.

Known Issues

A warning is thrown on Julia v0.3.7 about ambiguous method definition. This doesn't happen on Julia v0.4-dev. I think the warning on v0.3.7 is erroneous, but any help would be appreciated.

License and Credits

License is MIT. This package profits from the hard work that went into astropy.coordinates, especially in terms of testing and coordinate system definitions.