File: qgsgraph.sip.in

package info (click to toggle)
qgis 3.40.11%2Bdfsg-1
  • links: PTS, VCS
  • area: main
  • in suites: forky, sid
  • size: 1,183,800 kB
  • sloc: cpp: 1,595,841; python: 372,637; xml: 23,474; sh: 3,761; perl: 3,664; ansic: 2,257; sql: 2,137; yacc: 1,068; lex: 577; javascript: 540; lisp: 411; makefile: 154
file content (283 lines) | stat: -rw-r--r-- 6,168 bytes parent folder | download | duplicates (12)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
/************************************************************************
 * This file has been generated automatically from                      *
 *                                                                      *
 * src/analysis/network/qgsgraph.h                                      *
 *                                                                      *
 * Do not edit manually ! Edit header and run scripts/sipify.py again   *
 ************************************************************************/







class QgsGraphEdge
{
%Docstring(signature="appended")
This class implements a graph edge
%End

%TypeHeaderCode
#include "qgsgraph.h"
%End
  public:
    QgsGraphEdge();

    QVariant cost( int strategyIndex ) const;
%Docstring
Returns edge cost calculated using specified strategy

:param strategyIndex: strategy index
%End

    QVector<QVariant> strategies() const;
%Docstring
Returns array of available strategies
%End

    int toVertex() const;
%Docstring
Returns the index of the vertex at the end of this edge.

.. seealso:: :py:func:`fromVertex`
%End

    int fromVertex() const;
%Docstring
Returns the index of the vertex at the start of this edge.

.. seealso:: :py:func:`toVertex`
%End

};


typedef QList<int> QgsGraphEdgeIds;

class QgsGraphVertex
{
%Docstring(signature="appended")
This class implements a graph vertex
%End

%TypeHeaderCode
#include "qgsgraph.h"
%End
  public:
    QgsGraphVertex();


    QgsGraphVertex( const QgsPointXY &point );
%Docstring
This constructor initializes QgsGraphVertex object and associates a
vertex with a point
%End

    QgsGraphEdgeIds incomingEdges() const;
%Docstring
Returns the incoming edge ids, i.e. edges which end at this node.

.. seealso:: :py:func:`outgoingEdges`
%End

    QgsGraphEdgeIds outgoingEdges() const;
%Docstring
Returns outgoing edge ids, i.e. edges which start at this node.

.. seealso:: :py:func:`incomingEdges`
%End

    QgsPointXY point() const;
%Docstring
Returns point associated with graph vertex.
%End

};


class QgsGraph
{
%Docstring(signature="appended")
Mathematical graph representation
%End

%TypeHeaderCode
#include "qgsgraph.h"
%End
  public:
    QgsGraph();


    int addVertex( const QgsPointXY &pt );
%Docstring
Add a vertex to the graph
%End

    int addEdge( int fromVertexIdx, int toVertexIdx, const QVector<QVariant> &strategies );
%Docstring
Add an edge to the graph, going from the ``fromVertexIdx`` to
``toVertexIdx``.
%End

    int vertexCount() const;
%Docstring
Returns number of graph vertices
%End


    QgsGraphVertex vertex( int idx ) const;
%Docstring
Returns the vertex at the given index.

:raises IndexError: if the vertex is not found.
%End
%MethodCode
    if ( sipCpp->hasVertex( a0 ) )
    {
      return sipConvertFromNewType( new QgsGraphVertex( sipCpp->vertex( a0 ) ), sipType_QgsGraphVertex, Py_None );
    }
    else
    {
      PyErr_SetString( PyExc_IndexError, QByteArray::number( a0 ) );
      sipIsErr = 1;
    }
%End


    void removeVertex( int index );
%Docstring
Removes the vertex at specified ``index``.

All edges which are incoming or outgoing edges for the vertex will also
be removed.

:raises IndexError: if the vertex is not found.

.. versionadded:: 3.24
%End
%MethodCode
    if ( sipCpp->hasVertex( a0 ) )
    {
      sipCpp->removeVertex( a0 );
    }
    else
    {
      PyErr_SetString( PyExc_IndexError, QByteArray::number( a0 ) );
      sipIsErr = 1;
    }
%End

    int edgeCount() const;
%Docstring
Returns number of graph edges
%End


    QgsGraphEdge edge( int idx ) const;
%Docstring
Returns the edge at the given index.

:raises IndexError: if the edge is not found.
%End
%MethodCode
    if ( sipCpp->hasEdge( a0 ) )
    {
      return sipConvertFromNewType( new QgsGraphEdge( sipCpp->edge( a0 ) ), sipType_QgsGraphEdge, Py_None );
    }
    else
    {
      PyErr_SetString( PyExc_IndexError, QByteArray::number( a0 ) );
      sipIsErr = 1;
    }
%End



    void removeEdge( int index );
%Docstring
Removes the edge at specified ``index``.

The incoming and outgoing edges for all graph vertices will be updated
accordingly. Vertices which no longer have any incoming or outgoing
edges as a result will be removed from the graph automatically.

:raises IndexError: if the vertex is not found.

.. versionadded:: 3.24
%End
%MethodCode
    if ( sipCpp->hasEdge( a0 ) )
    {
      sipCpp->removeEdge( a0 );
    }
    else
    {
      PyErr_SetString( PyExc_IndexError, QByteArray::number( a0 ) );
      sipIsErr = 1;
    }
%End

    int findVertex( const QgsPointXY &pt ) const;
%Docstring
Find vertex by associated point

:return: vertex index
%End


    int findOppositeEdge( int index ) const;
%Docstring
Finds the first edge which is the opposite of the edge with the
specified index.

This represents the edge which has the same vertices as the specified
edge, but the opposite direction in the graph.(I.e. the edge which
starts at the "from" vertex of the specified edge and ends at the "to"
vertex.)

Returns -1 if no opposite edge exists.

:raises IndexError: if the edge with the specified ``index`` is not
                    found.

.. versionadded:: 3.24
%End
%MethodCode
    if ( sipCpp->hasEdge( a0 ) )
    {
      sipRes = sipCpp->findOppositeEdge( a0 );
    }
    else
    {
      PyErr_SetString( PyExc_IndexError, QByteArray::number( a0 ) );
      sipIsErr = 1;
    }
%End

    bool hasEdge( int index ) const;
%Docstring
Returns whether the edge of the given index exists.

.. versionadded:: 3.24
%End

    bool hasVertex( int index ) const;
%Docstring
Returns whether the vertex of the given index exists.

.. versionadded:: 3.24
%End

  protected:


};

/************************************************************************
 * This file has been generated automatically from                      *
 *                                                                      *
 * src/analysis/network/qgsgraph.h                                      *
 *                                                                      *
 * Do not edit manually ! Edit header and run scripts/sipify.py again   *
 ************************************************************************/