to_gring#

to_gring(sids)#

Converts a (collection of) sid(s) to (a collection of) the 3 great circles constraining the trixel(s).

Parameters
sids: int or collection of ints

sids to covert to great circles

Returns
great_circles: numpy.array

Great circles constraining the trixels. Three great circles per trixel defined by their ECEF norm vector. First dimensions are SIDs, second dimension are the 3 great circle (1 through 3), third dimension are x/y/z.

Examples

>>> import starepandas
>>> sids = [4611263805962321926, 4611404543450677254]
>>> starepandas.to_gring(sids)
array([[[ 0.01728414, -0.03191472, -0.01202901],
        [ 0.00073153,  0.03145575, -0.02172531],
        [-0.00036603,  0.03111274, -0.02225885]],
       [[-0.01693076,  0.00082534,  0.03429666],
        [-0.01582108,  0.0011905 ,  0.03478885],
        [ 0.01728414, -0.03191472, -0.01202901]]])