Package: cavsiopy
cavsiopy: Calculation and Visualization of Spacecraft Instrument OrientationWelcome to cavsiopy!'cavsiopy' is an open source Python package, which was specifically developed to determine the look direction of the Radio Receiver Instrument (RRI) on the e-POP/ CASSIOPE/ Swarm-E for HF radio wave propagation studies, but can be applied to any satellite mission requiring accurate pointing information. Given the spacecraft position, the roll, yaw, and pitch angles, the body vector of the instrument, and a target location, the pointing direction and orientation of the instrument onboard the spacecraft with respect to the target can be determined in various reference frames. 'cavsiopy' supports the reference frames: Geocentric Equatorial Inertial J2000 (GEI J2K), Earth Centered Earth Fixed (ECEF), International Terrestrial Reference Frame (ITRF), geodetic North-East-Down, and geocentric North-East-Center.cavsiopy contains routines forRotating the look direction of an instrument on-board the spacecraft in orbital frameCalculation of the look angles of the spacecraft (elevation and azimuth)Calculation of the look angles of the instrument (elevation and azimuth)Calculation of the distance between the spacecraft and a designated point on the groundCalculation of the line-of-sight direction vector from the target to the spacecraft locationTransformations between GEI J2K, ECEF, NED, NEC, ICRF, ITRF reference framesVisualization of spacecraft and instrument direction in 2D and 3D (simple or overlaid on geographical regions of the Earth below the satellite trajectory)Rotation matrices for rotations by x, y, z axesInstrument pointing direction vectors can be obtained in GEI J2K, ECEF, NED, NEC, ICRF, ITRF.CitationIf you use any of the cavsiopy functions/modules/plots please cite the software using DOI:https://doi.org/10.5281/zenodo.8361256as in:Kalafatoglu Eyiguler, E. C., Holley, W., Howarth, A. D., Danskin, D. W., Pandey, K., Martin, C. J., et al. (2023b). icebearcanada/cavsiopy: v1.1.1. doi:10.5281/zenodo.8361256cavsiopy in-action:under review:E. Ceren Kalafatoglu Eyiguler, Warren Holley, Andrew D. Howarth, Donald W. Danskin, Kuldeep Pandey, Carley J. Martin, Robert G. Gillies, Andrew W. Yau, Glenn C. Hussey (2023). cavsiopy: A Python package to calculate and visualize spacecraft instrument orientation. Manuscript submitted for publication.published:Kalafatoglu Eyiguler, E. C., Danskin, D., Hussey, G., Pandey, K., Gillies, R., and Yau, A. (2022). Satellite attitude effects on the reception of transionospheric hf signals: Examples from the radio receiver instrument onboard e-pop/swarm-e. In 2022 3rd URSI Atlantic and Asia Pacific Radio Science Meeting(AT-AP-RASC) (IEEE), 1–4Kalafatoglu Eyiguler, E. C., Danskin, D. W., Howarth, A. D., Holley, W., Pandey, K., Gillies, R. G., et al. (2023). Attitude effects on the observed orientation angle of hf waves from the radio receiver instrument on e-pop/swarm-e. In Ionospheric Effects Symposium 2023 (IES2023), ed. K. Groves (Alexandria, VA, USA: IES 2023), 1–6Pandey, K., Eyiguler, E. K., Gillies, R. G., Hussey, G. C., Danskin, D. W., and Yau, A. W. (2022). Polarization characteristics of a single mode radio wave traversing through the ionosphere: A unique observation from the rri on epop/swarm-e. Journal of Geophysical Research: Space Physics 127. doi:10.1029/2022JA030684DocumentationDetailed documentation onreadthedocs.orgDependenciesnumpy, matplotlib, astropy, cartopy, geopy, h5py, pysofa2Installation using pip:Before installing cavsiopy some of the dependencies may need special installation instructions:cartopyIf you are installing cartopy via pip (on Ubuntu/Debian) first libgeos-dev has to be on your system:$ sudo apt -y install libgeos-devPlease follow the installation guide of cartopy for other systems from here:https://scitools.org.uk/cartopy/docs/latest/installing.htmlinstallation of cartopy using conda:$ conda install -c conda-forge cartopyOther packages and requirementsDownload the requirements.txt from our [GitHub repository] (https://github.com/icebearcanada/cavsiopy)$ pip install -r requirements.txt** Now, we are good to go! **$ pip install cavsiopyVersion 1.2.2Patch release:slew_example.py: added to examplesin attitude_analysis.py: functions in utils.py and complement_missing_sofa.py are now embedded in attitude_analysis.pyuse_rotation_matrices.py: utils.py and missing_complement_sofa.py imports removedattitude_analysis.spacecraft_distance_from_a_point: fixed a minor bug, which caused the distance array to return empty.requirements.txt: version numbers were added for dependencies..readthedocs.yaml: version number and installation instructions corrected.The structural changes in items 2 and 3  do not affect any end-user experience / call to functions etc.Version 1.2.1Minor release: change in the return parameters of find_attitude and cas_ephemeris.attitude_analysis.find_attitude: East-North-Up: enu and Easth-North-Center(up): enc_u have been added to the returns.utils.py: added to find the location of coefficient files for pysofa, and removed the declaration of coefficient files for pysofa for the find_attitude function.ephemeris_importer.cas_ephemeris: Eclipse parameter can now be imported using ephemeris_importer.cas_ephemeris function from the CAS_ephemeris data files.__init__.py: Citation information has been added.requirements.txt: file has been updated.Version 1.1.1patch release:'attitude_plotter.attitude_3d_ground_quiver': has been enhanced to display a line connecting the subsatellite point with the ground target on the ground map.rri_example.py: rotate_rri is renamed as 'rotate_inst.'auxiliary\preliminary_data_analysis.py: name changes for plot_data_validity, import_quaternions.Version 1.1.0'pysofa2' integration.In previous versions, cavsiopy used the 'pysofa' package developed by Frederic Grollier from 2010.Starting from version 1.1.0, we have transitioned to using 'pysofa2.'To address missing functions in 'pysofa2,' we introduced 'complement_missing_sofa.py,' which utilizes the SOFA C Library compiled by 'pysofa2.'Version 1.0.0Initial major release: Uses pysofa (https://pypi.org/project/pysofa/) to compute the ICRF to ITRF rotation matrixBefore v1.0.0Test releasesCredits: E. Ceren Kalafatoglu Eyiguler, Warren Holley, Andrew D. Howarth, Donald W. Danskin, Kuldeep Pandey, Carley J. MartinContributing: Glenn C. Hussey, Robert G. Gillies, Andrew W. Yau