EVOLUTION-MANAGER

Edit File: gnm_utilities.dox

/*! \page gnm_utilities GNM Utility Programs

There are several Geographical Network Model (GNM) utilities:

<ul>
<li> \ref gnmmanage - Manages networks
<li> \ref gnmanalyse - Analyses networks
</ul>

/*! \page gnmmanage gnmmanage

Manages networks

\section gnmmanage_synopsis SYNOPSIS

\verbatim
gnmmanage [--help][-q][-quiet][--long-usage]
          [info]
          [create [-f format_name] [-t_srs srs_name] [-dsco NAME=VALUE]... ]
          [import src_dataset_name] [-l layer_name]
          [connect gfid_src gfid_tgt gfid_con [-c cost] [-ic inv_cost] [-dir dir]]
          [disconnect gfid_src gfid_tgt gfid_con]
          [rule rule_str]
          [autoconnect tolerance]
          [delete]
          [change [-bl gfid][-unbl gfid][-unblall]]
          gnm_name [layer [layer ...]]

\endverbatim

\section gnmmanage_description DESCRIPTION

The gnmmanage program can perform various managing operations on geographical networks in GDAL. In addition to creating and deleting networks this includes capabilities of managing network's features, topology and rules.

<dl>

<dt> info:</dt><dd> Different information about network: system and class layers, network metadata, network spatial reference. </dd>

<dt> create:</dt><dd> Create network. </dd>
<dl>
 <dt> -f format_name:</dt><dd> Output file format name. </dd>
 <dt> -t_srs srs_name:</dt><dd> Spatial reference input. </dd>
 <dt> -dsco NAME=VALUE:</dt><dd> Network creation option set as pair name=value. </dd>
</dl>

<dt> import src_dataset_name:</dt><dd> Import layer with dataset name to copy. </dd>
<dl>
 <dt> -l layer_name:</dt><dd> Layer name in dataset. If unset, 0 layer is copied. </dd>
</dl>

<dt> connect gfid_src gfid_tgt gfid_con:</dt><dd> Make a topological connection, where the gfid_src and gfid_tgt are vertexes and gfid_con is edge (gfid_con can be -1, so the system edge will be inserted). </dd>
<dl>
 <dt> -c cost -ic inv_cost -dir dir:</dt><dd> Manually assign the following values: the cost (weight), inverse cost and direction of the edge (optional). </dd>
</dl>

<dt> disconnect gfid_src gfid_tgt gfid_con:</dt><dd> Removes the connection from the graph. </dd>

<dt> rule rule_str:</dt><dd> Creates a rule in the network by the given rule_str string. </dd>

<dt> autoconnect tolerance:</dt><dd> Create topology automatically with the given double tolerance and layer names. In no layer name provided all layers of network will be used.</dd>

<dt> delete:</dt><dd> Delete network. </dd>

<dt> change:</dt><dd> Change blocking state of network edges or vertices. </dd>

<dt> -bl gfid:</dt><dd> Block feature before the main operation. Blocking features are saved in the special layer. </dd>

<dt> -unbl gfid:</dt><dd> Unblock feature before the main operation. </dd>

<dt> -unblall:</dt><dd> Unblock all blocked features before the main operation. </dd>

<dt> gnm_name:</dt><dd> The network to work with (path and name). </dd>

<dt> layer:</dt><dd> The network layer name. </dd>

</dl>

\if man
\section gnmmanage_author AUTHORS
Mikhail Gusev <gusevmihs@gmail.com>
Dmitry Baryshnikov <polimax@mail.ru>
\endif
*/

/*! \page gnmanalyse gnmanalyse

Analyses networks

\section gnmanalyse_synopsis SYNOPSIS

\verbatim
gnmanalyse [--help][-q][-quiet][--long-usage]
           [dijkstra start_gfid end_gfid [[-alo NAME=VALUE] ...]]]
           [kpaths start_gfid end_gfid k [[-alo NAME=VALUE] ...]]]
           [resource [[-alo NAME=VALUE] ...]]]
           [-ds ds_name][-f ds_format][-l layer_name]
           [[-dsco NAME=VALUE] ...][-lco NAME=VALUE]
           gnm_name
\endverbatim

\section gnmanalyse_description DESCRIPTION

The gnmanalyse program provides analysing capabilities of geographical networks in GDAL. The results of calculations are return in an OGRLayer format or as a console text output if such layer is undefined. All calculations are made considering the blocking state of features.

<dl>

<dt> dijkstra start_gfid end_gfid:</dt><dd> Calculates the best path between two points using Dijkstra algorithm from start_gfid point to end_gfid point. </dd>

<dt> kpaths start_gfid end_gfid:</dt><dd> Calculates K shortest paths between two points using Yen's algorithm (which internally uses Dijkstra algorithm for single path calculating) from start_gfid point to end_gfid point. </dd>

<dt> resource:</dt><dd> Calculates the "resource distribution". The connected components search is performed using breadth-first search and starting from that features which are marked by rules as 'EMITTERS'. </dd>

<dt> -ds ds_name:</dt><dd> The name&path of the dataset to save the layer with resulting paths. Not need to be existed dataset. </dd>

<dt> -f ds_format:</dt><dd> Define this to set the format of newly created dataset. </dd>

<dt> -l layer_name:</dt><dd> The name of the resulting layer. If the layer exist already - it will be rewritten. </dd>

<dt> gnm_name:</dt><dd> The network to work with (path and name). </dd>

<dt> -dsco NAME=VALUE:</dt><dd> Dataset creation option (format specific)</dd>
<dt> -lco NAME=VALUE:</dt><dd> Layer creation option (format specific)</dd>
<dt> -alo NAME=VALUE:</dt><dd> Algorithm option (format specific)</dd>
</dl>

\if man
\section gnmanalyse_author AUTHORS
Mikhail Gusev <gusevmihs@gmail.com>
Dmitry Baryshnikov <polimax@mail.ru>
\endif
*/