===========================================================================

   POMME: POtsdam Magnetic Model of the Earth
   -------==------=--------=------------=----

   Version    3
   Subversion 1

   2006-Jan-23  Stefan Maus, NOAA.GOV
   ----------------------------------

   Directories:

      ./Docu          Documentation.

      ./C             Core routines from Stefan Maus with
                      some modifications from Martin Rother,
                      at least one little bugfix since version POMME 2.3.

      ./F             Field calculation routines in Fortran
                      converted to C code for easier integration
                      in Matlab and IDL wrapper code

      ./D             required sets of coefficients and transformation
                      parameters; of course the new set 'pomme-3.1.cof'
                      should be used, but the old 'pomme-2.5.cof' is 
                      still in here.

      ./I             IDL/call_external wrapper code, test appl. and utils.

      ./M             Matlab/mex wrapper code, test appl. and utils.

      ./P             test of a perl script under construction to 'homogenize' 
                      the layout of the pomme3 cof file and to create some cof 
                      files containing only subsets of the original one.
   
   Files:

      Makefile        Demo makefile to build examples on main level
                      and in the wrapper subdirectories, used in 
                      GFZ Magnetic Field section with Solaris and Linux;
                      not intended to be generally applicable!

      example1.c      main example C code
      example2.c
      example3.c     

   The IDL and Matlab wrapper subdirecties contain their own example/test
   files, all are written for internal use and may not work without modifi-
   cation in other environments.
   
   But experiences with POMME version 2 shows, that the code is working 
   for Solaris (Unix) and (SuSE)-Linux.

   The code is still in a test evaluation by the GFZ ME group, so you
   may want to look for updates/bugfixes from time to time; in particular 
   the documentation is still poor.


   The time to calculate a 1-90 degree single model vector (without initiali-
   zation/interface overhead!) is quite long: on a single CPU of a SUN V880 
   (900 MHZ cpu) about 10-15ms/vector.

   A short run with the profiler of 'gcc version 3.3.2' on Sparc/Solaris
   gives (only most signifcant routines):
-------------------------------------------------------------------------------
Flat profile:

Each sample counts as 0.01 seconds.
  %   cumulative   self              self     total           
 time   seconds   seconds    calls  ms/call  ms/call  name    
 27.09      2.75     2.75     2000     1.38     1.38  magfdz
 20.00      4.78     2.03     2000     1.01     1.01  plmbar
 18.03      6.61     1.83     1000     1.83     1.83  gsm2geo_green
 10.25      7.65     1.04     2000     0.52     0.52  gsm2geo
  9.85      8.65     1.00                             internal_mcount
  7.49      9.41     0.76     1000     0.76     3.50  pomme_internal_field_mp
  3.45      9.76     0.35  8384370     0.00     0.00  indx
  1.77      9.94     0.18     1000     0.18     0.18  sm2geo_green
  0.89     10.03     0.09     1000     0.09     5.61  pomme_external_field_mp
  0.59     10.09     0.06     3000     0.02     0.02  sm2geo
  0.39     10.13     0.04                             _mcount
  0.10     10.14     0.01    98256     0.00     0.00  indx
  0.10     10.15     0.01     1000     0.01     0.01  magfdz_ext
-------------------------------------------------------------------------------

   as can be seen, most the time is used by the core routines 'magfdz'
   and 'plmbar' and the external field coordinate transformation.

   2004-Dec-14. prepared by using Stefan Maus' original C core code
                Martin Rother, GFZ-Potsdam, Germany (rother@gfz-potsdam.de).
   2004-Dec-18. fixed typo in IDL utility.
   2005-Dec-25. fixed typo in core routine pomme2d3.c, but will not 
                change any results, if delivered 'cof'-file is used.
   2006-Jan-23. version 3.1, seems to be runnning (out of the box) with the
                new 3.1 coefficient file.
===========================================================================
