Documentation for NAG Fortran Library

The document NAG Fortran Library contains an overview of NAG and information on its use that should be read prior to reading this document.

Local UNIX configuration information

Essential information about the local setup and use of NAG at the University of Delaware is in the Getting Started with NAG: Setting up your UNIX Account document. In addition, the document X Windows Configuration Setup for Using NAG provides UNIX account configuration suggestions to simplify access to the NAG example programs described below.

Documentation on the current version of NAG

The documention is available online as text-only documents. After setting up your UNIX account as described in the Getting Started with NAG document, you can view the NAG introduction by typing:

  lynx $NAG_DIR/doc/

You should get

                                       /opt/nag/aslir6/flso619da/doc/ directory

Current directory is /opt/nag/aslir6/flso619da/doc/

    -rw-r--r--    1 root     other       4859 Sep 21  2000 blas_lapack_to_nag
    -rw-r--r--    1 root     other    1425395 Sep 21  2000 called
    -rw-r--r--    1 root     other     949993 Sep 21  2000 calls
    -rw-r--r--    1 root     other      37641 Sep 21  2000 essint
    -rw-r--r--    1 root     other      18249 Sep 21  2000 in.html
    -rw-r--r--    1 root     other        264 Sep 21  2000 nag_fl_un.3
    -rw-r--r--    1 root     other       4750 Sep 21  2000 nag_to_blas_lapack
    -rw-r--r--    1 root     other      10672 Sep 21  2000 news
    -rw-r--r--    1 root     other       9188 Sep 21  2000 replaced
    -rw-r--r--    1 root     other     104337 Sep 21  2000 summary
    -rw-r--r--    1 root     other      18020 Sep 21  2000 un.html

The "Essential Introduction" is available by following the link labeled essint. The news link has informatation about changes to the library, and un.html contains the user notes. If you have a netscape-launching script in your path, you may be able see the "User Notes" to your currently running browser with the command: (The browser has to be running on strauss to have this work.)

   netscape-launcher $NAG_DIR/doc/un.html

Example programs you can copy, compile and run

There are three aliases in your .localalias file if you have followed the directions in Getting Started with NAG: Setting up your UNIX Account. Here we describe how to use these to work with the example programs in the NAG directory.

exampleList: list of the example names
exampleGet Example name: Using one of the names you can get a copy if the Fortran example file.
make Example name: Compile and load the example to be run.
exampleRun Example name: Run the example and remove it from your disk space if there are no errors.

The Example name is an encoded name which stars with the NAG chapter, such as c02 (Curve and Surface Fitting), followed by a three letter routine code, such as daf (Least-squares surface fit, bicubic splines), and terminated by the letter e. For a complete list of the NAG chapters and routine codes see NAG Fortran Library: Library Contents. Don't forget to append the "e" to the example name.

Here is a complete example where we list the e02 chapter examples, Pick and example to copye, make and run.

<29>% mkdir nagexample
<30>% cd nagexample
<31>% nagshell
<1>% exampleList | grep e02
e01bhfe  e01dafe  e01rafe  e01rbfe  e01safe  e01sefe  e02acfe
e02adfe  e02aefe  e02affe  e02agfe  e02ahfe  e02ajfe  e02akfe
e02bafe  e02bbfe  e02bcfe  e02bdfe  e02befe  e02cafe  e02cbfe
e02dafe  e02dcfe  e02ddfe  e02defe  e02dffe  e02gafe  e02gbfe
e02gcfe  e02rafe  e02rbfe  e02zafe  e04abfe  e04bbfe  e04ccfe
<2>% exampleGet e02dafe
<3>% make e02dafe
f77   -o e02dafe e02dafe.f -L/opt/nag/aslir6/flso619da -lnag
e02dafe.f:
 MAIN:
<4>% exampleRun e02dafe
 E02DAF Example Program Results
 
 Interior Y-knots
     -0.5000
      0.0000
 
 Interior X-knots
 None
 
 Sum of squares of residual RHS        1.47D+01
 
 Rank   22
 
 X and Y have been interchanged
 
       X          Y          Data       Fit     Residual
     -0.9500    -0.6100    -1.7900    -1.7931  -0.31D-02
     -0.8700    -0.7000    -1.7600    -1.7521   0.79D-02
     -0.7700    -0.7700    -1.8200    -2.4301  -0.61D+00
     -0.6300    -0.2600     8.8800     7.6346  -0.12D+01
     -0.6600    -0.8300    -2.0100    -1.5815   0.43D+00
     -0.5400    -0.8800    -2.4200    -2.6795  -0.26D+00
     -0.7200    -0.1400     7.1500     7.5708   0.42D+00
     -1.0000    -1.0000    -1.0000    -1.0228  -0.23D-01
     -0.4000    -0.9000    -3.3400    -4.6955  -0.14D+01
     -0.2400    -0.9100    -6.5200    -4.7072   0.18D+01
     -0.4100    -0.1600     2.3200     2.7039   0.38D+00
     -0.0500    -0.3500     1.6600     2.2865   0.63D+00
      0.6000    -0.5200     0.9300     0.9441   0.14D-01
      0.8700     0.9300     0.3600     0.3529  -0.71D-02
      0.8400     0.0900     0.5200     0.5024  -0.18D-01
      0.1700     0.8800     0.4900     0.4705  -0.20D-01
      1.0000     1.0000     0.3300     0.6315   0.30D+00
      0.1000     1.0000     0.4800     1.4910   0.10D+01
      0.2400     0.3000     0.6500     0.9241   0.27D+00
      0.3200    -0.2300     0.9200    -0.3692  -0.13D+01
      1.0000    -1.0000     1.0000     1.0835   0.84D-01
      0.9300     0.2200     0.4700     1.4912   0.10D+01
      0.1500     0.8900     0.4900     0.4414  -0.49D-01
      0.9900    -0.8000     0.8400     0.5495  -0.29D+00
      0.4400     0.6800     0.4700     1.5862   0.11D+01
      0.6300     0.6700     0.4400     0.6288   0.19D+00
      0.2000    -0.8400     2.7800     1.7123  -0.11D+01
      0.4300     0.8400     0.4400     0.6888   0.25D+00
      0.2800     0.1500     0.7000     0.7713   0.71D-01
      0.8600    -0.3500     0.6600     0.9347   0.27D+00
 
 Sum of squared residuals        1.47D+01
 
 Spline coefficients
     -1.0228   115.4668  -433.5558   -68.1973
     24.8426  -140.1485   258.5042    15.6756
    -29.4878   132.2933  -173.5103    20.0983
      9.9575   -51.6200    67.6666    -5.8765
     10.0577     4.7543   -15.3533    -0.3260
      1.0835    -2.7932     7.7708     0.6315
<5>% ls
e02dafe.f
<6>% exit
exit

Additional documentation available on the Web

NAG, Inc. provides the additional online documentation from their web page

The NIST (National Institute for Standards and Technology) web site provides another valuable information tool, the Guide to Available Mathematical Software (GAMS) server. The GAMS server helps you find documentation and examples for all FNL routines by name. It also has a a decision tree that guides you to appropriate routines from NAG as well as other mathematical and statistical libraries.

Finally, HotGAMS, NIST's Java interface to GAMS, is accessible from any system that has a Java appletviewer installed. For example, from the central UNIX servers (e.g., Strauss), you would type

  appletviewer http://gams.nist.gov/HOTGAMS/HotGAMS.html  &

[Back to NAG home page]