NAG DMC, Release 2


Linux (Intel) Gnu C

Users' Note


1. Introduction

This document is essential reading for every user of NAG DMC implementation specified in the title. It provides implementation-specific detail that augments the information provided in the documentation.

In addition, NAG recommends that before calling any NAG DMC function users should read the following reference material (see Section 4):

(a) Essential Introduction
(b) User Guide
(c) The relevant Function Document

2. Availability of Functions

All 70 functions are available in this implementation. Your suggestions for new algorithms for inclusion in future releases of the NAG DMC are welcomed (see Section 6).

3. General Information

3.1. Accessing NAG DMC

Assuming that libnagdmc.a has been installed in a directory in the search path of the linker, such as /usr/lib, and that the NAG DMC include files have been moved to /usr/include, then you may link to NAG DMC in the following manner:

gcc -o driver.exe driver.c -lnagdmc -lpthread -lm
where driver.c is your application program. If libnagdmc.a is in a location other than /usr/lib, such as /opt/NAG/lib, and the include files are in a location other than /usr/include, such as /opt/NAG/include, then you may link to NAG DMC in the following manner:
gcc -o driver.exe -I/opt/NAG/include driver.c -L/opt/NAG/lib -lnagdmc 
    -lpthread -lm

3.2. Example Programs

A number of example programs are provided in the directory examples. Where an example program refers to a data file, users should check that the file name (including path) is appropriate for their system before compiling the source text.

In order to compile and link an example, say pca_ex.c, copy the source files from the directory examples to your current directory. If a data file is required, copy the data file from the directory examples to the current directory or modify the source text to include the path to the data file.

Issue the compilation command

gcc -o pca_ex.exe pca_ex.c -lnagdmc -lpthread -lm

This command will create in the current directory an executable file called pca_ex.exe.

4. Documentation

Full documentation is provided in the form of PDF and HTML files. The documentation is available in the documents directory. Please note that if you do not have a PDF viewer available then the Adobe Acrobat Reader can be downloaded free of charge from the Adobe Web site at

NAG DMC documentation consists of:

Hyperlinks in the PDF documents can be used to navigate between these four sets of documentation. The example code documentation is launched from the function documents in the user's default browser.

5. Support from NAG

(a) Contact with NAG

Queries concerning this document or the implementation generally should be directed initially to your local Advisory Service. If you have difficulty in making contact locally, you can contact NAG directly at one of the addresses given in the Appendix. Users subscribing to the support service are encouraged to contact one of the NAG Response Centres (see below).

(b) NAG Response Centres

The NAG Response Centres are available for general enquiries from all users and also for technical queries from sites with an annually licenced product or support service.

The Response Centres are open during office hours, but contact is possible by fax, e-mail and phone (answering machine) at all times.

When contacting a Response Centre it helps us deal with your enquiry quickly if you can quote your NAG site reference and NAG product code (in this case DRLUX20DA).

(c) NAG Websites

The NAG websites provide information about implementation availability, descriptions of products, downloadable software, product documentation and technical reports. The NAG websites can be accessed at:, (in North America) or (in Japan)

(d) NAG Electronic Newsletter

If you would like to be kept up to date with news from NAG then please register to receive our free electronic newsletter, which will alert you to special offers, announcements about new products or product/service enhancements, customer stories and NAG's event diary. You can register via one of our websites, or by contacting us at:

6. User Feedback

Many factors influence the way NAG's products and services evolve and your ideas are invaluable in helping us to ensure that we meet your needs. If you would like to contribute to this process we would be delighted to receive your comments. Please contact your local NAG Response Centre (shown below).

Appendix - Contact Addresses

Wilkinson House
Jordan Hill Road
OXFORD OX2 8DR NAG Ltd Response Centre
United Kingdom email:

Tel: +44 (0)1865 511245 Tel: +44 (0)1865 311744
Fax: +44 (0)1865 310139 Fax: +44 (0)1865 310139

1431 Opus Place, Suite 220
Downers Grove
IL 60515-1362 NAG Inc Response Center
USA email:

Tel: +1 630 971 2337 Tel: +1 630 971 2345
Fax: +1 630 971 2706 Fax: +1 630 971 2706

Nihon NAG KK
Hatchobori Frontier Building 2F

Tel: +81 (0)3 5542 6311
Fax: +81 (0)3 5542 6312