NAG Data Mining Components, Release 1

DRDLL10DA

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

(Microsoft Visual C++)

Users' Note



Contents


1. Introduction

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

2. Availability of Functions

All 36 functions identified in the file Doc\clist.html are available in this implementation. Your suggestions for new algorithms for inclusion in future releases of the NAG Data Mining Components are welcomed (see Section 5).

3. General Information

3.1. Accessing the NAG Data Mining Components

Assuming that the NAG Data Mining Components have been installed in the default directory c:\Program Files\Numerical Algorithms Group\Data Mining, then you may compile and link a driver program named driver.c with the NAG Data Mining Components in the following manner:

Using Microsoft Visual C++

cl /I &
"c:\Program Files\Numerical Algorithms Group\Data Mining\Include" driver.c &
"c:\Program Files\Numerical Algorithms Group\Data Mining\Library\nag_dmc.lib" &
user32.lib
where nag_dmc.lib is the NAG Data Mining Components import library and user32.lib is the user32 import library that comes with Visual C++. Note that the line is continued by escaping the newline character with '&'.

The installation procedure for the NAG Data Mining Components 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 Data Mining Components as follows:

cl driver.c nag_dmc.lib user32.lib

If you are using Developer Studio, after establishing a workspace you should make the system aware of the NAG Data Mining Components 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 Data Mining Components. 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. License Management

Use of the NAG Data Mining Components is controlled by software license management. In this implementation should the license key not be appropriate for the computer system being used then no computation will be performed and the error flag, info[0], will be set to -999.

3.3. Example Programs

A number of example programs are provided in the directory Examples. Some of these examples refer to data files, consequently users should check that the file name is appropriate for their system before compiling the source text. Furthermore, for the example programs named in the following table one additional file must be compiled and linked in order to build an executable program.

Example File Additional File Needed
basic_logistic_exf.c iris_sp.c
dt_exf.c df_iris.c
hclust_exf.c iris.c
kmeans_exf.c iris.c
knnc_exf.c df_iris.c
knnp_exf.c df_iris.c
logistic_exf.c iris_sp.c
pca_exf.c iris.c
regr_exf.c iris_sp.c

In order to compile and link an example, say pca_exf.c, then copy the source files from the directory Examples to your current directory. Examine the source to see whether a data file is required. If it is then copy the data file from the directory Examples to the current directory and modify the source text to reflect the local file name.

Issue the compilation command

cl iris.c pca_exf.c nag_dmc.lib user32.lib

The exception to this is the ODBC example contained in file odbc_ex.c. This example requires that some ODBC software is installed on your system as well as the NAG Data Mining Components. If you have not already done so, install Microsoft Data Access Components Version 2.6 or later on to your system. Once installed the example file odbc_ex.c can be compiled in the way as other NAG Data Mining Components examples, e.g.

cl odbc_ex.c nag_dmc user32.lib

3.4. User Documentation

Full documentation is provided online. The documentation comprises HTML and PDF files, the root of which is file nag_dmc_intro.html. You should check how these files have been made available locally. 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/.

4. Support from NAG

(a) How to Contact NAG

If you have any queries concerning the use of this product please contact NAG directly using one of the methods given 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, email and phone (answering machine) at all times.

When contacting a Response Centre please quote your NAG site reference and NAG product code (in this case DRDLL10DA).

(c) NAG Websites

The NAG websites are an information service providing items of interest to users and prospective users of NAG products and services. The information is reviewed and updated regularly and includes implementation availability, descriptions of products, downloadable software, product documentation and technical reports. The NAG websites can be accessed at

http://www.nag.co.uk/

or

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 you may want to register to receive our electronic newsletter, which will alert you to special offers, announcements about new products or product/service enhancements, case studies and NAG's event diary. To register visit one of our websites or contact us at nagnews@nag.co.uk.

5. 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 by email at feedback@nag.co.uk. Alternatively contact the appropriate NAG Response Centre who will be happy to record your comments.

Appendix - How to Contact NAG

NAG Ltd
Tel: +44 (0)1865 511245
Fax: +44 (0)1865 310139   
                               
NAG Ltd Response Centre
email: support@nag.co.uk
Tel: +44 (0)1865 311744
Fax: +44 (0)1865 310139
 
NAG Inc
Tel: +1 630 971 2337 
Fax: +1 630 971 2706                    
                   
NAG Inc Response Center
email: infodesk@nag.com
Tel: +1 630 971 2345
Fax: +1 630 971 2706
 
Nihon NAG KK
Tel: +81 (0)3 5542 6311
Fax: +81 (0)3 5542 6312

email: help@nag-j.co.jp


[NP3628/UN]