NAG DMC, Release 2

DRDLL20DA

Windows 95/98/NT/2000/XP Dynamic Link Library (32-bit)

Users' Note





Contents



1. Introduction

This document is essential reading for every user of the 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) 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 the NAG DMC

Assuming that the NAG DMC have been installed in the default directory C:\Program Files\Numerical Algorithms Group\DMC\DRDLL20DA, then you may compile and link a file driver.c (containing a 'main' function) with the NAG DMC in the following manner:

Using Microsoft Visual C/C++ Compiler:

cl /I &
"c:\Program Files\Numerical Algorithms Group\DMC\DRDLL20DA\Include" driver.c &
"c:\Program Files\Numerical Algorithms Group\DMC\DRDLL20DA\Library\nagdmc.lib" &
user32.lib
where driver.c is your application program, nagdmc.lib is the NAG DMC import library and user32.lib is the user32 import library that comes with Microsoft Visual C++. Note that a line is continued by escaping the newline character with '&'.

The installation procedure for the NAG DMC attempts to add the location of the include files and the import library to the Microsoft compiler environment variables INCLUDE and LIB, respectively. If this has been achieved successfully then you may link with the NAG DMC as follows:

cl driver.c nagdmc.lib user32.lib

If you are using Developer Studio, after establishing a workspace you should make the system aware of the NAG DMC by clicking on Project, then Settings, then Link and entering the library under Object/library modules. The installation procedure attempts to make Developer Studio aware of the location of the NAG DMC. You can confirm that it has been successful by examining the Directories pane when Tools/Options/Directories/Show directories for/Libraries has been selected. If the installation had difficulty, perhaps because several versions of Developer Studio were recorded in the registry, then you can set this facility manually in the Directories pane; otherwise you will have to specify the full path name of the libraries in Object/library modules.

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 file 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

cl pca_ex.c nagdmc.lib user32.lib
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 Doc 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 http://www.adobe.com/.

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 licensed 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 DRDLL20DA).

(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:

http://www.nag.co.uk/, http://www.nag.com/ (in North America) or http://www.nag-j.co.jp/ (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: nagnews@nag.co.uk.

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

NAG Ltd
Wilkinson House
Jordan Hill Road
OXFORD OX2 8DR NAG Ltd Response Centre
United Kingdom email: support@nag.co.uk

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

NAG Inc
1431 Opus Place, Suite 220
Downers Grove
IL 60515-1362 NAG Inc Response Center
USA email: infodesk@nag.com

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
4-9-9
Hatchobori
Chuo-ku
Tokyo
104-0032
Japan
email: help@nag-j.co.jp

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