PROCEDURE: MVN_PFP_COTRANS PURPOSE: Performs the coordinate transformation from the MAVEN PFP instrument cooridnate system to that of you set. Now SWIA, SWEA, STATIC coordinate systems are applicable. CALLING SEQUENCE: mvn_pfp_cotrans, data, from='MAVEN_STATIC', to='MAVEN_MSO', $ vx=vx, vy=vy, vz=vz, theta=theta, phi=phi, $ px=px, py=py, pz=pz INPUTS: Any SWIA, SWEA, and STATIC data. These data should be derived from the following functions: - SWIA: mvn_swia_get_3dc(), mvn_swia_get_3df(), mvn_swia_get_3ds(). - SWEA: mvn_swe_get3d(), mvn_swe_getpad(), mvn_swe_getspec(). - STATIC: mvn_sta_get_**(); (** corresponds to any apid modes). KEYWORDS: FROM: Defines the initial coordinate system as string. TO: Defines the coordinate system to which you want to convert. Both "from" and "to" keywords must be defined the coordinate system written in the MAVEN SPICE frame kernels. It means that the coordinate system(s) derived from the SPICE/Kernels can be utilized, such as 'MAVEN_MSO', 'IAU_MARS', or so on in the present version. In additions, this procedure can convert to the 2 new useful coordinate system. One is the local geographic coordinate system, which is defined as 'LGEO'. The coordinate system is centered at the spacecraft and decomposes into zonal(East-West), meridional(North-South), and radial components: - X: Positive toward the local East. - Y: Positive toward the local North. - Z: Positive away from the planetary surface. This coordinate system has been utilized in MGS IMF draping direction proxy. The other is the streamline-aligned geographic coordinate system, which is defined as 'SGEO'. The coordinate system is centered at the spacecraft. The streamline direction is determined under the assumption that flow is symmetrical both the Mars-Sun line and mainly tangential(horizontal) to the obstracle. - X: Streamline flown from the dayside to nightside. - Y: Z x X (Completes right-handed system; horizontal). - Z: Positive away from the planetary surface. The detailed definision and useful figure are shown in Strangeway and Russell [1996, JGR]. Vi: (i=X, Y, Z). Returns unit vector compnents in the new coordinate system. THETA: Returns the polar angle in the new coordinate system. PHI: Returns the azimuth angle in the new coordinate system. Pi: (i=X, Y, Z). Returns the instrument axis direction in the new coordinate system. STATUS: Returns the conversion result (0:Fail/1:Success). SPICE_LOAD: Loads the MAVEN SPICE/kernels. CREATED BY: Takuya Hara on 2014-11-24. $LastChangedBy: hara $ $LastChangedDate: 2014-12-09 17:51:20 -0800 (Tue, 09 Dec 2014) $ $LastChangedRevision: 16430 $ $URL: svn+ssh://thmsvn@ambrosia.ssl.berkeley.edu/repos/spdsoft/trunk/projects/maven/eph/mvn_pfp_cotrans.pro $ MODIFICATION LOG: (YYYY-MM-DD) 2014-11-24: Starts to prepare this routine. 2014-12-09: Header description is written up.