1 /*
2  * Copyright (c) 2013, The University of Oxford
3  * All rights reserved.
4  *
5  * Redistribution and use in source and binary forms, with or without
6  * modification, are permitted provided that the following conditions are met:
7  * 1. Redistributions of source code must retain the above copyright notice,
8  *    this list of conditions and the following disclaimer.
9  * 2. Redistributions in binary form must reproduce the above copyright notice,
10  *    this list of conditions and the following disclaimer in the documentation
11  *    and/or other materials provided with the distribution.
12  * 3. Neither the name of the University of Oxford nor the names of its
13  *    contributors may be used to endorse or promote products derived from this
14  *    software without specific prior written permission.
15  *
16  * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
17  * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
18  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
19  * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
20  * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
21  * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
22  * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
23  * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
24  * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
25  * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
26  * POSSIBILITY OF SUCH DAMAGE.
27  */
28 
29 #ifndef OSKAR_COORDS_CONVERT_GALACTIC_TO_FK5_H_
30 #define OSKAR_COORDS_CONVERT_GALACTIC_TO_FK5_H_
31 
32 /**
33  * @file oskar_convert_galactic_to_fk5.h
34  */
35 
36 #include <oskar_global.h>
37 
38 #ifdef __cplusplus
39 extern "C" {
40 #endif
41 
42 /**
43  * @brief
44  * Convert Galactic to FK5 (J2000) equatorial coordinates (single precision).
45  *
46  * @details
47  * This function converts Galactic to FK5 (J2000) equatorial coordinates.
48  *
49  * @param[in]  num_points The number of points to transform.
50  * @param[in]  l          The Galactic longitudes in radians.
51  * @param[in]  b          The Galactic latitudes in radians.
52  * @param[out] ra         The FK5 (J2000) equatorial Right Ascensions in radians.
53  * @param[out] dec        The FK5 (J2000) equatorial Declination in radians.
54  */
55 OSKAR_EXPORT
56 void oskar_convert_galactic_to_fk5_f(int num_points, const float* l,
57         const float* b, float* ra, float* dec);
58 
59 /**
60  * @brief
61  * Convert Galactic to FK5 (J2000) equatorial coordinates (double precision).
62  *
63  * @details
64  * This function converts Galactic to FK5 (J2000) equatorial coordinates.
65  *
66  * @param[in]  num_points The number of points to transform.
67  * @param[in]  l          The Galactic longitudes in radians.
68  * @param[in]  b          The Galactic latitudes in radians.
69  * @param[out] ra         The FK5 (J2000) equatorial Right Ascensions in radians.
70  * @param[out] dec        The FK5 (J2000) equatorial Declination in radians.
71  */
72 OSKAR_EXPORT
73 void oskar_convert_galactic_to_fk5_d(int num_points, const double* l,
74         const double* b, double* ra, double* dec);
75 
76 #ifdef __cplusplus
77 }
78 #endif
79 
80 #endif /* OSKAR_CONVERT_GALACTIC_TO_FK5_H_ */
81