COIN-OR::LEMON - Graph Library

Changeset 1631:e15162d8eca1 in lemon-0.x for doc


Ignore:
Timestamp:
08/16/05 21:06:59 (19 years ago)
Author:
Alpar Juttner
Branch:
default
Phase:
public
Convert:
svn:c9d7d8f5-90d6-0310-b91f-818b3a526b0e/lemon/trunk@2139
Message:

Fixed most (but not all) of Doxygen warnings

Location:
doc
Files:
3 edited

Legend:

Unmodified
Added
Removed
  • doc/graph_io.dox

    r1540 r1631  
    123123\subsection write Writing a graph
    124124
    125 The \c GraphWriter class provides the graph output. To write a graph
     125The \ref lemon::GraphWriter "GraphWriter" template class
     126provides the graph output. To write a graph
    126127you should first give writing commands to the writer. You can declare
    127128writing command as \c NodeMap or \c EdgeMap writing and labeled Node and
     
    132133\endcode
    133134
    134 The \c writeNodeMap() function declares a \c NodeMap writing command in the
    135 \c GraphWriter. You should give a name to the map and the map
     135The \ref lemon::GraphWriter::writeNodeMap() "writeNodeMap()"
     136function declares a \c NodeMap writing command in the
     137\ref lemon::GraphWriter "GraphWriter".
     138You should give a name to the map and the map
    136139object as parameters. The NodeMap writing command with name "id" should write a
    137140unique map because it will be regarded as an ID map.
     
    148151\endcode
    149152
    150 With the \c writeEdgeMap() member function you can give an edge map
     153With the \ref lemon::GraphWriter::writeEdgeMap() "writeEdgeMap()"
     154member function you can give an edge map
    151155writing command similar to the NodeMaps.
    152156
     
    161165\endcode
    162166
    163 With \c writeNode() and \c writeEdge() functions you can designate Nodes and
     167With \ref lemon::GraphWriter::writeNode() "writeNode()"
     168and \ref lemon::GraphWriter::writeEdge() "writeEdge()"
     169functions you can designate Nodes and
    164170Edges in the graph. For example, you can write out the source and target node
    165171of a maximum flow instance.
     
    172178\endcode
    173179
    174 With \c writeAttribute() function you can write an attribute to the file.
     180With \ref lemon::GraphWriter::writeAttribute() "writeAttribute()"
     181function you can write an attribute to the file.
    175182
    176183\code
     
    179186\endcode
    180187
    181 After you give all write commands you must call the \c run() member
     188After you give all write commands you must call the
     189\ref lemon::GraphWriter::run() "run()" member
    182190function, which executes all the writing commands.
    183191
     
    190198The file to be read may contain several maps and labeled nodes or edges.
    191199If you read a graph you need not read all the maps and items just those
    192 that you need. The interface of the \c GraphReader is very similar to
    193 the GraphWriter but the reading method does not depend on the order of the
     200that you need. The interface of the \ref lemon::GraphReader "GraphReader"
     201is very similar to
     202the \ref lemon::GraphWriter "GraphWriter"
     203but the reading method does not depend on the order of the
    194204given commands.
    195205
     
    202212\endcode
    203213
    204 The \c readNodeMap() function reads a map from the \c nodeset section.
     214The \ref lemon::GraphReader::readNodeMap() "readNodeMap()"
     215function reads a map from the \c nodeset section.
    205216If there is a map that you do not want to read from the file and there are
    206217whitespaces in the string represenation of the values then you should
    207 call the \c skipNodeMap() template member function with proper parameters.
     218call the \ref lemon::GraphReader::skipNodeMap() "skipNodeMap()"
     219template member function with proper parameters.
    208220
    209221\see QuotedStringReader
     
    219231\endcode
    220232
    221 With the \c readEdgeMap() member function you can give an edge map
     233With the \ref lemon::GraphReader::readEdgeMap() "readEdgeMap()"
     234member function you can give an edge map
    222235reading command similar to the NodeMaps.
    223236
     
    227240\endcode
    228241
    229 With \c readNode() and \c readEdge() functions you can read labeled Nodes and
     242With \ref lemon::GraphReader::readNode() "readNode()"
     243and \ref lemon::GraphReader::readEdge() "readEdge()"
     244functions you can read labeled Nodes and
    230245Edges.
    231246
     
    237252\endcode
    238253
    239 With \c readAttribute() function you can read an attribute from the file.
     254With \ref lemon::GraphReader::readAttribute() "readAttribute()"
     255function you can read an attribute from the file.
    240256
    241257\code
     
    246262\endcode
    247263
    248 After you give all read commands you must call the \c run() member
     264After you give all read commands you must call the
     265\ref lemon::GraphReader::run() "run()" member
    249266function, which executes all the commands.
    250267
     
    258275
    259276To read a map (on the nodes or edges)
    260 the \c GraphReader should know how to read a Value from the given map.
     277the \ref lemon::GraphReader "GraphReader"
     278should know how to read a Value from the given map.
    261279By the default implementation the input operator reads a value from
    262280the stream and the type of the readed value is the value type of the given map.
     
    338356\endcode
    339357
    340 There are similar classes to the \c GraphReader ans \c GraphWriter
    341 which handle the undirected graphs. These classes are the
    342 \c UndirGraphReader and \UndirGraphWriter.
    343 
    344 The \c readUndirMap() function reads an undirected map and the
    345 \c readUndirEdge() reads an undirected edge from the file,
     358There are similar classes to the \ref lemon::GraphReader "GraphReader" and
     359\ref lemon::GraphWriter "GraphWriter" which
     360handle the undirected graphs. These classes are
     361the \ref lemon::UndirGraphReader "UndirGraphReader"
     362and \ref lemon::UndirGraphWriter "UndirGraphWriter".
     363
     364The \ref lemon::UndirGraphReader::readUndirMap() "readUndirMap()"
     365function reads an undirected map and the
     366\ref lemon::UndirGraphReader::readUndirEdge() "readUndirEdge()"
     367reads an undirected edge from the file,
    346368
    347369\code
     
    365387character. The file may contains comment lines with \c # first character.
    366388
    367 The \c LemonReader and \c LemonWriter gives a framework to read and
     389The \ref lemon::LemonReader "LemonReader"
     390and \ref lemon::LemonWriter "LemonWriter"
     391gives a framework to read and
    368392write sections. There are various section reader and section writer
    369 classes which can be attached to a \c LemonReader or a \c LemonWriter.
     393classes which can be attached to a \ref lemon::LemonReader "LemonReader"
     394or a \ref lemon::LemonWriter "LemonWriter".
    370395
    371396There are default section readers and writers for reading and writing
     
    373398the format described above. Other type of data can be handled with own
    374399section reader and writer classes which are inherited from the
    375 \c LemonReader::SectionReader or the \c LemonWriter::SectionWriter classes.
     400\c LemonReader::SectionReader or the
     401\ref lemon::LemonWriter::SectionWriter "LemonWriter::SectionWriter"
     402classes.
    376403
    377404The next example defines a special section reader which reads the
     
    415442In our example there is a network with symmetric links and there are assymetric
    416443traffic request on the network. This construction can be stored in an
    417 undirected graph and in a directed NewEdgeSetAdaptor class. The example
    418 shows the input with the LemonReader class:
     444undirected graph and in a directed \c NewEdgeSetAdaptor class. The example
     445shows the input with the \ref lemon::LemonReader "LemonReader" class:
    419446
    420447\code
     
    434461\endcode
    435462
    436 Because the GraphReader and the UndirGraphReader can be converted
    437 to LemonReader and it can resolve the ID's of the items, the previous
    438 result can be achived with the UndirGraphReader class, too.
     463Because both the \ref lemon::GraphReader "GraphReader"
     464and the \ref lemon::UndirGraphReader "UndirGraphReader" can be converted
     465to \ref lemon::LemonReader "LemonReader"
     466and it can resolve the ID's of the items, the previous
     467result can be achived with the \ref lemon::UndirGraphReader "UndirGraphReader"
     468class, too.
    439469
    440470
  • doc/graphs.dox

    r1200 r1631  
    3535\ref lemon::concept::ExtendableGraph "ExtendableGraph" concept,
    3636so you cannot delete individual edges or nodes.
    37 \li \ref lemon::SymListGraph "SymListGraph" and
    38 \ref lemon::SymSmartGraph "SymSmartGraph" classes are very similar to
    39 \ref lemon::ListGraph "ListGraph" and \ref lemon::SmartGraph "SmartGraph".
    40 The difference is that whenever you add a
    41 new edge to the graph, it actually adds a pair of oppositely directed edges.
    42 They are linked together so it is possible to access the counterpart of an
    43 edge. An even more important feature is that using these classes you can also
    44 attach data to the edges in such a way that the stored data
    45 are shared by the edge pairs.
    4637\li \ref lemon::FullGraph "FullGraph"
    4738implements a complete graph. It is a
  • doc/license.dox

    r1536 r1631  
    33\page license License Terms
    44
    5 \verbinclude ../LICENSE
     5\verbinclude LICENSE
    66
    77*/
Note: See TracChangeset for help on using the changeset viewer.