m_geo2mag.m

A mapping package for Matlab:这是一款功能十分强大的地理绘图工具包

function [longMAG,latMAG,phiVecMAG,thetaVecMAG]=m_geo2mag(longGEO,latGEO,phiVecGEO,thetaVecGEO)
% M_GEO2MAG  Converts geographic to geomagnetic coordinates.
%   [longMAG,latMAG]=M_GEO2MAG(longGEO,latGEO) converts MAGGEOnetic 
%   (dipole) coordinates to MAGgraphic coordinates.  IGRF 2000 is used 
%   to determine the location of the MAGGEOnetic dipole. All in units of 
%   degrees with + longitudes east. All variables can be scalar or matrix 
%   but must have the same size.
%
%    Vector rotations can be carried using
% 
%  [lonMAGG,latMAG,phiVecMAG,thetaVecMAG]=M_GEO2MAG(longGEO,latGEO,phiVecGEO,thetaVecGEO)
%
%   where
%
% phiVecGEO   - east component of the vector in geographic coordinates
% thetaVecGEO - north component of the vector in geographic coordinates
% phiVecMAG   - east component of the vector in geomagnetic coordinates
% thetaVecMAG - north component of the vector in geomagnetic coordinates
%
% See also M_MAG2GEO

% References:
%
% Hapgood, M.A., Space Physics Coordinate Transformations:
% A User Guide, Planet. Space Sci., Vol. 40, N0. 5, 1992.

if nargin==2,
   [longMAG,latMAG]=mc_coords('geo2mag',longGEO,latGEO);
elseif nargin==4,
   [longMAG,latMAG,phiVecMAG,thetaVecMAG]=mc_coords('geo2mag',longGEO,latGEO,phiVecGEO,thetaVecGEO);
else
   error('Wrong number of input parameters');
end;