source: trunk/Alps/examples/Abc/INSTALL @ 277

Last change on this file since 277 was 277, checked in by andreasw, 13 years ago

first working version with autotools

File size: 3.7 KB
Line 
1PREREQUISITES FOR INSTALLATION
2==============================
3
4NOTE: CoinDir is the path to the directory of COIN
5NOTE: AlpsDir is the path to the directory of COIN/Alps
6NOTE: AbcDir is the path to the directory of COIN/Example/Abc
7NOTE: TargetDir is the path to the directory where targets are put in,
8      whose name is derived from the platform name (as returned by `uname`)
9      and the optimization level (e.g., AbcDir/Linux-g or AbcDir/Linux-O)
10
111. Download the necessary components (Alps, Coin, Clp, Osi, Cgl) of COIN
12   - Alps depends on Coin.
13   - Abc depends on Coin, Clp, Osi, Cgl
142. At the moment, on (*)nix platforms, you must use g++ 2.95.2 or higher.
153. must use gnu make
164. To make the documentation, doxygen must be installed
17
18
19TO BUILD AND RUN SERIAL ABC
20===========================
21
221. Build Alps serial library. Please refer to the INSTALL file in AlpsDir.
23
242. Build Abc. In AbcDir, 'make' to build the executable,
25   which will be placed in the target subdirectory (TargetDir).
26
273. Change parameters if users do want to use the default values.
28   AlpsDir/include/AlpsParams.h has explanations of each parameter.
29   There are two ways to change parameters:
30   - parameter file: AbcDir/abc.par
31   - command line
32
33   Users must specify:
34   - which instance to solve
35
36   Users can specify:
37   - maximum solution time
38   - log level, etc.
39
404. To run Abc, in AbcDir, type
41
42        TargetDir/abc -param abc.par
43
44   Abc can also read in parameters from command line, for instance
45
46        TargetDir/abc -Alps_instance ./data/flugpl.mps
47       
48
49TO BUILD AND RUN PARALLEL ABC
50=============================
51
521. Build Alps parallel library. Please refer to the INSTALL file in AlpsDir.
53
542. Build Abc. In AbcDir, 'make' to build the executable, which will
55   be placed in the target subdirectory (TargetDir).
56
573. If do NOT want to use the default parameter values, users can modify them.
58   (AlpsDir/include/AlpsParams.h has explanations of each parameter.)
59
60   There are two ways to change parameters:
61   - parameter file: AbcDir/abc.par
62   - command line
63
64   Users must specify:
65   - which instance to solve
66   - how many processes to be launched
67
68   Users can specify:
69   - how many hubs
70   - maximum solution time
71   - log level, etc.
72
734. The way to run parallel version depends on users' computing environment.
74   Users can ask help from their system administrators if not sure.
75   A general way:
76
77   - in AbcDir, type
78
79      mpirun -np numProcesses TargetDir/abc -param abc.par
80       
81
82SOLVER OUTPUT
83=============
84 
85For example, in AbcDir, type following command to solve instance flugpl using
86serial Abc:
87
88./Linux-g/abc -Alps_instance data/flugpl.mps
89
90The message to screen is as follows:
91(Note users might see a bit different output depends on LP solver and system)
92
93*****************************
94* ALPS Version 0.6 (Serial) *
95*****************************
96
97Reading in ALPS parameters ...
98Reading in ABC parameters ...
99Coin0001I At line 15 NAME          FLUGPL
100Coin0001I At line 16 ROWS
101Coin0001I At line 36 COLUMNS
102Coin0001I At line 89 RHS
103Coin0001I At line 94 BOUNDS
104Coin0001I At line 111 ENDATA
105Coin0002I Problem FLUGPL has 18 rows, 18 columns and 46 elements
106Coin0008I FLUGPL read with 0 errors
107Problem = flugpl
108Data file = data/flugpl.mps
109Log file = flugpl.log
110
111Abc0010I Process[-10]: after 0 nodes, 0 on tree, 1e+80 best solution, best possible 1e+75
112Abc0010I Process[-10]: after 50 nodes, 33 on tree, 1e+80 best solution, best possible 1.19089e+06
113
114....
115
116Abc0010I Process[-10]: after 2800 nodes, 343 on tree, 1.2015e+06 best solution, best possible 1.19702e+06
117Number of nodes processed = 5671
118Number of nodes left = 0
119Tree depth = 35
120Search CPU time = 3.2605 seconds
121Search wallclock = 3.89941 seconds
122Best solution quality = 1.2015e+06
123
Note: See TracBrowser for help on using the repository browser.