## Euredit Platform Components User Guide

### Contents

- 1. Compatibility
- 2. Example programs
- 3. Compiling example programs

### 1. Compatibility

The Euredit platform software components are distrbuted as a 32-bit DLL which is compatible with Windows 95/98/NT/2000/XP.

### 2. Example programs

Each example program consists of a C driver (main) program that shows how to use one or more of the components. These example programs can be adapted to suit a user's data set and needs by changing parameter settings in the example C code.

Example program | Components used | Data file(s) | Results file
--- | --- | --- | ---
anova_tree_ex.c | anova_tree; tree_save; tree_free; tree_load; tree_score | complete.dat; impute.dat | anova_tree_ex.res
bacon_ex.c | bacon; em | continuous.dat | bacon_ex.res
data_conv_ex.c | data_conv | categorical.dat | categorical_xml.res; categorical_xsl.res; categorical_xdr.res (the generated XML files)
em_ex.c | em | continuous.dat | em_ex.res
gen_imp_ex.c | gen_imp | categorical.dat | gen_imp_ex.res
gini_tree_ex.c | gini_tree; tree_save; tree_free; tree_load; tree_score | complete.dat; impute.dat | gini_tree_ex.res
simp_imp_ex.c | simp_imp | categorical.dat | simp_imp_ex.res
waid_tree_ex.c | waid_tree; tree_save; tree_free; tree_load; tree_score | complete.dat; impute.dat | waid_tree_ex.res
xml_impute_ex.c | xml_data_size; xml_read; simp_imp; xml_update | categorical.xml; categorical.xdr; categorical.xsl (as generated on the user's system) | xml_impute_ex.res (the updated categorical.xml file)

The directory esys/vb_demo_gui/exe/ts-som/c++ contains a Microsoft Visual C++ project file for the TS-SOM example program as supplied by the Laboratory of Data Analysis, University of Jyväakylä (see Horppu and Koikkalainen for more information regarding its use).

### 3. Compiling example programs

Assuming that the Euredit platform software DLL (esys.dll) is on your path, you may compile and link a driver program named driver.c with the platform software using Microsoft Visual C++ in one of two ways:

1. In MS-DOS type:

       cl /I LOCATION_OF_EUREDIT_SYS.H driver.c FULL_PATH_OF_ESYS.LIB user32.lib

   where:
   1. LOCATION_OF_EUREDIT_SYS.H is the full path to the directory on your system that contains the euredit_sys.h file, e.g., "c:\work\Euredit\Platform\inc"
   2. FULL_PATH_OF_ESYS.LIB is the full path of the import library for esys.dll, e.g., "c:\work\Euredit\Platform\lib\esys.lib"
   3. user32.lib is the user32 import library that comes with Visual C++

   Alternatively, if the Microsoft compiler environment variables INCLUDE and LIB are set to the value of the location of euredit_sys.h and the full path of the esys.dll import library respectively, then the following MS-DOS command will suffice.

       cl driver.c esys.lib user32.lib

2. If you are using Developer Studio, after establishing a workspace you should make the system aware of the Euredit platform software by clicking on Project, then Settings, then:
   1. click on the Link tab and enter the library name (esys.lib) under Object/library modules. Then select Input from the Category drop-down list and type the full path to esys.lib in the Additional library path dialogue box
   2. click on the C/C++ tab and select Preprocessor from the Category drop-down list. Enter the path to the euredit_sys.h file in the dialogue box underneath Additional include directories
3. Add an example program to the workspace you have created, then build the project.

Platform software homepage