[3] | 1 | /* -*- mode: C++; indent-tabs-mode: nil; -*- |
---|
| 2 | * |
---|
| 3 | * This file is a part of LEMON, a generic C++ optimization library. |
---|
| 4 | * |
---|
| 5 | * Copyright (C) 2003-2008 |
---|
| 6 | * Egervary Jeno Kombinatorikus Optimalizalasi Kutatocsoport |
---|
| 7 | * (Egervary Research Group on Combinatorial Optimization, EGRES). |
---|
| 8 | * |
---|
| 9 | * Permission to use, modify and distribute this software is granted |
---|
| 10 | * provided that this copyright notice appears in all copies. For |
---|
| 11 | * precise terms see the accompanying LICENSE file. |
---|
| 12 | * |
---|
| 13 | * This software is provided "AS IS" with no warranty of any kind, |
---|
| 14 | * express or implied, and with no claim as to its suitability for any |
---|
| 15 | * purpose. |
---|
| 16 | * |
---|
| 17 | */ |
---|
| 18 | |
---|
| 19 | /** |
---|
[9] | 20 | \page hello_lemon Compile Your First Code |
---|
[6] | 21 | |
---|
| 22 | If you have installed LEMON on your system you can paste the following |
---|
| 23 | code segment into a file called <tt>hello_lemon.cc</tt> to have a first |
---|
| 24 | working program that uses LEMON. |
---|
| 25 | |
---|
| 26 | \dontinclude hello_lemon.cc |
---|
| 27 | \skip #include |
---|
| 28 | \until } |
---|
| 29 | |
---|
| 30 | First let us briefly explain how this example program works. |
---|
[9] | 31 | (The used notions will be discussed in detail in the following sections.) |
---|
[6] | 32 | |
---|
| 33 | After some convenience typedefs we create a directed graph (\e digraph) |
---|
| 34 | and add some nodes and arcs to it. |
---|
| 35 | ListDigraph is one of the digraph classes implemented in LEMON. |
---|
| 36 | It is based on linked lists, therefore iterating through its nodes and |
---|
| 37 | arcs is fast. |
---|
| 38 | |
---|
| 39 | Then we iterate through all nodes of the digraph and print their unique |
---|
| 40 | IDs. We use a constructor of the node iterator to initialize it to the |
---|
| 41 | first node. |
---|
| 42 | The <tt>operator++</tt> is used to step to the next node. After the last |
---|
| 43 | node the iterator becomes invalid (i.e. it is set to \c INVALID). |
---|
| 44 | This is what we exploit in the stop condition. |
---|
| 45 | We iterate through all arcs of the digraph very similarly and print the |
---|
| 46 | IDs of their source (tail) and target (head) nodes using the \c source() |
---|
| 47 | and \c target() member functions. |
---|
| 48 | |
---|
| 49 | After that we create an arc map, which is actually a mapping that assigns |
---|
| 50 | an \c int value (length) to each arc, and we set this value for each arc. |
---|
| 51 | Finally we iterate through all arcs again and print their lengths. |
---|
| 52 | |
---|
[9] | 53 | Now let us compile this simple example program. |
---|
[6] | 54 | |
---|
[9] | 55 | \section hello_lemon_system If LEMON is Installed System-Wide |
---|
[6] | 56 | |
---|
[9] | 57 | If LEMON is installed system-wide (into directory \c /usr/local), |
---|
| 58 | then it is very easy to compile this program with the |
---|
[6] | 59 | following command (the argument <tt>-lemon</tt> tells the compiler |
---|
| 60 | that we are using the installed LEMON): |
---|
| 61 | |
---|
| 62 | \verbatim |
---|
[9] | 63 | g++ -lemon hello_lemon.cc -o hello_lemon |
---|
[6] | 64 | \endverbatim |
---|
| 65 | |
---|
| 66 | As a result you will get the exacutable \c hello_lemon in the current |
---|
| 67 | directory, which you can run by the following command. |
---|
| 68 | |
---|
| 69 | \verbatim |
---|
| 70 | ./hello_lemon |
---|
| 71 | \endverbatim |
---|
| 72 | |
---|
[9] | 73 | \section hello_lemon_user If LEMON is Installed User-Local |
---|
[6] | 74 | |
---|
| 75 | Compiling the code is a bit more difficult if you installed LEMON |
---|
| 76 | user-local into a directory (e.g. <tt>~/lemon</tt>) or if you just |
---|
| 77 | skipped the step <tt>make install</tt>. |
---|
| 78 | You have to issue a command like this. |
---|
| 79 | |
---|
| 80 | \verbatim |
---|
[9] | 81 | g++ -lemon -I ~/lemon -L ~/lemon/lemon/.libs hello_lemon.cc -o hello_lemon |
---|
[6] | 82 | \endverbatim |
---|
| 83 | |
---|
| 84 | If everything has gone well, then our program prints out the followings. |
---|
| 85 | |
---|
| 86 | \verbatim |
---|
| 87 | Hello World! |
---|
| 88 | This is LEMON library here. We have a direceted graph. |
---|
| 89 | |
---|
| 90 | Nodes: 3 2 1 0 |
---|
| 91 | Arcs: (2,3) (1,3) (1,2) (0,2) (0,1) |
---|
| 92 | |
---|
| 93 | There is a map on the arcs (length): |
---|
| 94 | |
---|
| 95 | length(2,3)=10 |
---|
| 96 | length(1,3)=25 |
---|
| 97 | length(1,2)=5 |
---|
| 98 | length(0,2)=20 |
---|
| 99 | length(0,1)=10 |
---|
| 100 | \endverbatim |
---|
| 101 | |
---|
| 102 | You may note that iterating through the nodes and arcs is done in the |
---|
| 103 | reverse order compared to the creating order (the IDs are in decreasing |
---|
| 104 | order). |
---|
| 105 | This is due to implementation aspects, that may differ at other graph |
---|
| 106 | types, moreover it may be changed in the next releases. |
---|
| 107 | Thus you should not exploit this method in any way, you should not |
---|
| 108 | suppose anything about the iteration order. |
---|
| 109 | |
---|
| 110 | If you managed to compile and run this example code without any problems, |
---|
| 111 | you can go on reading this tutorial to get to know more features and tools |
---|
| 112 | of LEMON. |
---|
| 113 | Otherwise if you encountered problems that you did not manage to solve, |
---|
| 114 | do not hesitate to |
---|
| 115 | <a href="mailto:lemon-user@lemon.cs.elte.hu"><b>contact us</b></a>. |
---|
| 116 | |
---|
[3] | 117 | */ |
---|