\contentsline {part}{I\hspace {1em}DEFINITIONS AND MATHEMATICAL FORMULAS}{7}
\contentsline {chapter}{\numberline {1}DESCRIPTION OF COORDINATE SYSTEMS}{9}
\contentsline {section}{\numberline {1.1}Geocentric Equatorial Inertial System (GEI)}{9}
\contentsline {section}{\numberline {1.2}Geographic System (GEO)}{10}
\contentsline {section}{\numberline {1.3}Geomagnetic system (MAG)}{10}
\contentsline {section}{\numberline {1.4}Geocentric Solar Ecliptic system (GSE)}{11}
\contentsline {section}{\numberline {1.5}Geocentric Solar Equatorial system (GSEQ)}{11}
\contentsline {section}{\numberline {1.6}Geocentric Solar Magnetospheric system (GSM)}{12}
\contentsline {section}{\numberline {1.7}Solar Magnetic system (SM)}{12}
\contentsline {section}{\numberline {1.8}Dipole Meridian system (DM)}{13}
\contentsline {section}{\numberline {1.9}Vertical Dusk Horizontal system (VDH)}{13}
\contentsline {section}{\numberline {1.10}Spin Reference system (SR)}{14}
\contentsline {section}{\numberline {1.11}Spin Reference 2 system (SR2)}{14}
\contentsline {section}{\numberline {1.12}Inverse SR2 system (ISR2)}{15}
\contentsline {section}{\numberline {1.13}Magnetic Field Aligned system (MFA)}{15}
\contentsline {section}{\numberline {1.14}Tangent Paraboloid Normal system (TPN)}{16}
\contentsline {chapter}{\numberline {2}DIAGRAM OF TRANSFORMATIONS}{17}
\contentsline {section}{\numberline {2.1}General remarks}{17}
\contentsline {section}{\numberline {2.2}Schematic diagram of transformations}{17}
\contentsline {section}{\numberline {2.3}List of transformations}{18}
\contentsline {chapter}{\numberline {3}MATHEMATICAL FORM OF TRANSFORMATIONS}{21}
\contentsline {section}{\numberline {3.1}General remarks on transformation matrix}{21}
\contentsline {section}{\numberline {3.2}GEI \nobreakspace {}\nobreakspace {}to GEO transformation}{22}
\contentsline {section}{\numberline {3.3}GEI \nobreakspace {}\nobreakspace {}to MAG transformation}{23}
\contentsline {section}{\numberline {3.4}GEI to \nobreakspace {}\nobreakspace {}SM transformation}{25}
\contentsline {section}{\numberline {3.5}GEI to \nobreakspace {}\nobreakspace {}GSM transformation}{27}
\contentsline {section}{\numberline {3.6}GEI to GSE transformation}{29}
\contentsline {section}{\numberline {3.7}GEI to GSEQ transformation}{30}
\contentsline {section}{\numberline {3.8}GEO to MAG transformation}{31}
\contentsline {section}{\numberline {3.9}GEO to SM\nobreakspace {}\nobreakspace {}transformation}{32}
\contentsline {section}{\numberline {3.10}GEO to GSM transformation}{34}
\contentsline {section}{\numberline {3.11}GEO to GSE transformation}{36}
\contentsline {section}{\numberline {3.12}GEO to GSEQ transformation}{38}
\contentsline {section}{\numberline {3.13}GEO to VDH transformation}{40}
\contentsline {section}{\numberline {3.14}GEO to DM transformation}{41}
\contentsline {section}{\numberline {3.15}GSE to SM\nobreakspace {}\nobreakspace {}transformation}{43}
\contentsline {section}{\numberline {3.16}GSE to GSM transformation}{45}
\contentsline {section}{\numberline {3.17}GSE to TPN transformation}{48}
\contentsline {section}{\numberline {3.18}GSE to ISR2 transformation}{51}
\contentsline {section}{\numberline {3.19}GSE to SR2 transformation}{53}
\contentsline {section}{\numberline {3.20}GSE to MFA transformation}{55}
\contentsline {section}{\numberline {3.21}GSE to GSEQ transformation}{58}
\contentsline {section}{\numberline {3.22}GSM to GSEQ transformation}{60}
\contentsline {section}{\numberline {3.23}GSM to MAG transformation}{61}
\contentsline {section}{\numberline {3.24}GSM to SM transformation}{62}
\contentsline {section}{\numberline {3.25}GSM to TPN transformation}{63}
\contentsline {section}{\numberline {3.26}SM\nobreakspace {}\nobreakspace {}to MAG transformation}{66}
\contentsline {section}{\numberline {3.27}SR2 to ISR2 transformation}{70}
\contentsline {section}{\numberline {3.28}SR\nobreakspace {}\nobreakspace {}to SR2 transformation}{71}
\contentsline {section}{\numberline {3.29}SR2 to MFA transformation}{72}
\contentsline {chapter}{\numberline {4}USE OF EULER ANGLES}{77}
\contentsline {section}{\numberline {4.1}General remarks}{77}
\contentsline {section}{\numberline {4.2}Definition of Euler angles}{77}
\contentsline {section}{\numberline {4.3}XYZ to VDH transformation}{78}
\contentsline {chapter}{\numberline {5}CALENDAR CONVERSIONS}{79}
\contentsline {section}{\numberline {5.1}General remarks}{79}
\contentsline {section}{\numberline {5.2}List of calendar computation utilities}{79}
\contentsline {subsection}{\numberline {5.2.1}Compute if a given year is or not a leap year (cp\_leap\_year)}{79}
\contentsline {subsection}{\numberline {5.2.2}Compute the number of day in a month (cp\_nbday\_in\_month)}{79}
\contentsline {subsection}{\numberline {5.2.3}Compute english day name from day in a week (cp\_en\_day\_name)}{79}
\contentsline {subsection}{\numberline {5.2.4}Compute french day name from day in a week (cp\_fr\_day\_name)}{79}
\contentsline {subsection}{\numberline {5.2.5}Compute english month name from month number (cp\_en\_month\_name)}{79}
\contentsline {subsection}{\numberline {5.2.6}Compute french month name from month number (cp\_fr\_month\_name)}{79}
\contentsline {section}{\numberline {5.3}List of calendar conversion utilities}{79}
\contentsline {subsection}{\numberline {5.3.1}Convert date to day of the year (cv\_date\_to\_doty)}{79}
\contentsline {subsection}{\numberline {5.3.2}Convert day of the year to date (cv\_doty\_to\_date)}{80}
\contentsline {subsection}{\numberline {5.3.3}Convert date to Julian day 1950 (cv\_date\_to\_jul1950)}{80}
\contentsline {subsection}{\numberline {5.3.4}Convert date to Julian day 2000 (cv\_date\_to\_jul2000)}{80}
\contentsline {subsection}{\numberline {5.3.5}Convert Julian day 1950 to date (cv\_jul1950\_to\_date)}{80}
\contentsline {subsection}{\numberline {5.3.6}Convert Julian day 2000 to date (cv\_jul2000\_to\_date)}{80}
\contentsline {subsection}{\numberline {5.3.7}Convert hour, min, sec to decimal hour (cv\_hms\_to\_dech)}{80}
\contentsline {subsection}{\numberline {5.3.8}Convert decimal hour to hour, min, sec (cv\_dech\_to\_hms)}{80}
\contentsline {subsection}{\numberline {5.3.9}Convert day, hour, min, sec,ms. to ms of the day (cv\_dhms\_to\_msotd)}{80}
\contentsline {subsection}{\numberline {5.3.10}Convert ms of the day to hour, min, sec., ms (cv\_msotd\_to\_hmsms)}{80}
\contentsline {subsection}{\numberline {5.3.11}Convert date to week number in a year (cv\_date\_to\_weekn)}{80}
\contentsline {subsection}{\numberline {5.3.12}Convert date to day of the week (cv\_date\_to\_dotw)}{80}
\contentsline {subsection}{\numberline {5.3.13}Convert the week number in a year to date (cv\_weekn\_to\_date)}{80}
\contentsline {part}{II\hspace {1em}USER'S MANUAL}{81}
\contentsline {chapter}{\numberline {6}DESCRIPTION OF AVAILABLE MODULES}{83}
\contentsline {section}{\numberline {6.1}General remarks}{83}
\contentsline {section}{\numberline {6.2}Description of ``Basic Computation" subroutines}{84}
\contentsline {section}{\numberline {6.3}Description of ``Calendar" subroutines}{86}
\contentsline {subsection}{\numberline {6.3.1}``compute" subroutines}{86}
\contentsline {subsection}{\numberline {6.3.2}``convert" subroutines}{87}
\contentsline {section}{\numberline {6.4}Description of ``Give" subroutines}{89}
\contentsline {section}{\numberline {6.5}Description of ``Read and check" subroutines}{90}
\contentsline {section}{\numberline {6.6}Description of ``Print information" subroutines}{90}
\contentsline {section}{\numberline {6.7}Description of ``Transformations" subroutines}{91}
\contentsline {section}{\numberline {6.8}Description of ``Matrix operations" subroutines}{98}
\contentsline {section}{\numberline {6.9}Summary of available subroutine}{100}
\contentsline {subsection}{\numberline {6.9.1}``Basic computation'' subroutines }{100}
\contentsline {subsection}{\numberline {6.9.2}``Calendar'' subroutines}{100}
\contentsline {subsection}{\numberline {6.9.3}``Read and check'' subroutines}{100}
\contentsline {subsection}{\numberline {6.9.4}``Give'' subroutines}{101}
\contentsline {subsection}{\numberline {6.9.5}``Matrix operations'' subroutines}{101}
\contentsline {subsection}{\numberline {6.9.6}``Print informations'' subroutine}{101}
\contentsline {subsection}{\numberline {6.9.7}``Transform'' subroutines}{102}
\contentsline {chapter}{\numberline {7}USEFUL PROGRAMS}{103}
\contentsline {section}{\numberline {7.1}General remarks}{103}
\contentsline {section}{\numberline {7.2}Example of simple programs}{104}
\contentsline {subsection}{\numberline {7.2.1}rocot\_example}{104}
\contentsline {subsection}{\numberline {7.2.2}latlon\_to\_xyz.exe}{105}
\contentsline {subsection}{\numberline {7.2.3}vdh\_to\_gse.exe}{106}
\contentsline {section}{\numberline {7.3}test programs}{107}
\contentsline {subsection}{\numberline {7.3.1}rocot\_check program}{107}
\contentsline {subsection}{\numberline {7.3.2}rocot\_check\_mva.exe}{107}
\contentsline {subsection}{\numberline {7.3.3}visu\_check\_mva.pro}{107}
\contentsline {subsection}{\numberline {7.3.4}test\_format.exe}{109}
\contentsline {subsection}{\numberline {7.3.5}test\_week.exe}{110}
\contentsline {subsection}{\numberline {7.3.6}test\_day\_in\_week.exe}{112}
\contentsline {subsection}{\numberline {7.3.7}test\_dir\_sun.exe}{114}
\contentsline {section}{\numberline {7.4}Usefull programs}{116}
\contentsline {subsection}{\numberline {7.4.1}rocot\_info.exe}{116}
\contentsline {subsection}{\numberline {7.4.2}rocot\_utility.exe}{116}
\contentsline {subsection}{\numberline {7.4.3}co\_julday\_table.exe}{119}
\contentsline {subsection}{\numberline {7.4.4}co\_mag\_time.exe}{120}
\contentsline {subsection}{\numberline {7.4.5}co\_sunset.exe}{120}
\contentsline {subsection}{\numberline {7.4.6}co\_sunset\_year.exe}{121}
\contentsline {subsection}{\numberline {7.4.7}co\_seasons.exe}{122}
\contentsline {chapter}{\numberline {8}SOFTWARE INSTALLATION}{123}
\contentsline {section}{\numberline {8.1}Available packages}{123}
\contentsline {subsection}{\numberline {8.1.1}F77 package}{123}
\contentsline {subsection}{\numberline {8.1.2}F90 package}{123}
\contentsline {subsection}{\numberline {8.1.3}C package}{123}
\contentsline {section}{\numberline {8.2}Installation on linux system}{123}
\contentsline {subsubsection}{step 1: Copy the directory Rocotlib\_V3p0}{123}
\contentsline {subsubsection}{step 2: Edit and choose compiler option in Makefile}{124}
\contentsline {subsubsection}{step 3: Compile source files and create executable}{124}
\contentsline {subsubsection}{step 4: Check program executions}{127}
\contentsline {subsubsection}{step 5: Check result with your own computer}{129}
\contentsline {section}{\numberline {8.3}Running all test programs}{129}
\contentsline {chapter}{\numberline {9}CHECK PROGRAM AND PORTABILITY}{131}
\contentsline {section}{\numberline {9.1}Check program }{131}
\contentsline {subsection}{\numberline {9.1.1}General remarks}{131}
\contentsline {subsection}{\numberline {9.1.2}Input rocot\_check.in data file for running check program}{131}
\contentsline {subsection}{\numberline {9.1.3}Output rocot\_check.out file from check program execution}{132}
\contentsline {section}{\numberline {9.2}Compare rocot\_check.out files}{146}
\contentsline {section}{\numberline {9.3}Running all available programs}{146}
\contentsline {section}{\numberline {9.4}Compare other .out files}{146}
\contentsline {section}{\numberline {9.5}Differences between codes and used compilers}{148}
\contentsline {subsection}{\numberline {9.5.1}Results obtained with two different compilers on the same code}{148}
\contentsline {subsection}{\numberline {9.5.2}Results obtained with the same compiler on F77 and F90 codes}{149}
\contentsline {subsection}{\numberline {9.5.3}Results obtained with gcc on C code and fort77 on F77 codes}{149}
\contentsline {subsection}{\numberline {9.5.4}Results obtained with gcc on C code and gfortran on F77 or F90 codes}{149}
\contentsline {subsection}{\numberline {9.5.5}Summary}{149}
\contentsline {chapter}{LISTE OF FIGURES}{156}
\contentsline {chapter}{LISTE OF TABLES}{156}
\contentsline {chapter}{ACKNOWLEDGMENTS}{156}
\contentsline {chapter}{BIBLIOGRAPHY}{156}
