File Coverage

erfasrc/src/pn.c
Criterion Covered Total %
statement 6 7 85.7
branch 1 2 50.0
condition n/a
subroutine n/a
pod n/a
total 7 9 77.7


line stmt bran cond sub pod time code
1             #include "erfa.h"
2              
3 5           void eraPn(double p[3], double *r, double u[3])
4             /*
5             ** - - - - - -
6             ** e r a P n
7             ** - - - - - -
8             **
9             ** Convert a p-vector into modulus and unit vector.
10             **
11             ** Given:
12             ** p double[3] p-vector
13             **
14             ** Returned:
15             ** r double modulus
16             ** u double[3] unit vector
17             **
18             ** Notes:
19             **
20             ** 1) If p is null, the result is null. Otherwise the result is a unit
21             ** vector.
22             **
23             ** 2) It is permissible to re-use the same array for any of the
24             ** arguments.
25             **
26             ** Called:
27             ** eraPm modulus of p-vector
28             ** eraZp zero p-vector
29             ** eraSxp multiply p-vector by scalar
30             **
31             ** Copyright (C) 2013-2020, NumFOCUS Foundation.
32             ** Derived, with permission, from the SOFA library. See notes at end of file.
33             */
34             {
35             double w;
36              
37              
38             /* Obtain the modulus and test for zero. */
39 5           w = eraPm(p);
40 5 50         if (w == 0.0) {
41              
42             /* Null vector. */
43 0           eraZp(u);
44              
45             } else {
46              
47             /* Unit vector. */
48 5           eraSxp(1.0/w, p, u);
49             }
50              
51             /* Return the modulus. */
52 5           *r = w;
53              
54 5           return;
55              
56             }
57             /*----------------------------------------------------------------------
58             **
59             **
60             ** Copyright (C) 2013-2020, NumFOCUS Foundation.
61             ** All rights reserved.
62             **
63             ** This library is derived, with permission, from the International
64             ** Astronomical Union's "Standards of Fundamental Astronomy" library,
65             ** available from http://www.iausofa.org.
66             **
67             ** The ERFA version is intended to retain identical functionality to
68             ** the SOFA library, but made distinct through different function and
69             ** file names, as set out in the SOFA license conditions. The SOFA
70             ** original has a role as a reference standard for the IAU and IERS,
71             ** and consequently redistribution is permitted only in its unaltered
72             ** state. The ERFA version is not subject to this restriction and
73             ** therefore can be included in distributions which do not support the
74             ** concept of "read only" software.
75             **
76             ** Although the intent is to replicate the SOFA API (other than
77             ** replacement of prefix names) and results (with the exception of
78             ** bugs; any that are discovered will be fixed), SOFA is not
79             ** responsible for any errors found in this version of the library.
80             **
81             ** If you wish to acknowledge the SOFA heritage, please acknowledge
82             ** that you are using a library derived from SOFA, rather than SOFA
83             ** itself.
84             **
85             **
86             ** TERMS AND CONDITIONS
87             **
88             ** Redistribution and use in source and binary forms, with or without
89             ** modification, are permitted provided that the following conditions
90             ** are met:
91             **
92             ** 1 Redistributions of source code must retain the above copyright
93             ** notice, this list of conditions and the following disclaimer.
94             **
95             ** 2 Redistributions in binary form must reproduce the above copyright
96             ** notice, this list of conditions and the following disclaimer in
97             ** the documentation and/or other materials provided with the
98             ** distribution.
99             **
100             ** 3 Neither the name of the Standards Of Fundamental Astronomy Board,
101             ** the International Astronomical Union nor the names of its
102             ** contributors may be used to endorse or promote products derived
103             ** from this software without specific prior written permission.
104             **
105             ** THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
106             ** "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
107             ** LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
108             ** FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE
109             ** COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,
110             ** INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING,
111             ** BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
112             ** LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
113             ** CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
114             ** LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN
115             ** ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
116             ** POSSIBILITY OF SUCH DAMAGE.
117             **
118             */