OriginDestinationCostMatrixResult

Zusammenfassung

An object containing the results of an origin destination cost matrix analysis that can be used to access outputs and solver messages.

Auswertung

Instances of this class cannot be created directly. Instead, they are returned by the solve method of the OriginDestinationCostMatrix class.

Eigenschaften

Eigenschaft	Erklärung	Datentyp
isPartialSolution (Nur lesen)	Returns True if the solver produced a partial solution, meaning that not all inputs were included in the results. This can occur if one of the inputs is unlocated and the solver class's ignoreInvalidLocations property is set to True.	Boolean
solveSucceeded (Nur lesen)	Returns True if the solve was successful.	Boolean

Methodenübersicht

Methode	Erklärung
count (output_type)	Returns the number of rows for an output type.
export (output_type, output_features)	The output features will be created in the spatial reference of the network dataset used for the analysis. If the arcpy.env.outputCoordinateSystem environment is set, the output features will be created with the specified coordinate system instead. Exports the analysis results to a feature class or table.
fieldNames (output_type)	Returns a list of field names supported by a specified output type.
saveAsLayerFile (file_name)	Save the analysis result and settings to a layer file or layer package. The layer file or package can be opened in ArcGIS Pro as a record of the analysis settings or to visualize the results. A layer file can also be opened in ArcGIS Desktop. A layer package cannot be saved if the analysis references a portal service as the network data source. The method returns a RuntimeError exception if the allowSaveLayerFile property on the solver object is set to False.
searchCursor (output_type, field_names, {where_clause})	Establishes a search cursor on the specified output type. This cursor can be used to read rows directly from the output.
solverMessages (severity)	Get error, warning, and informational messages returned by the solver.

Methoden

count (output_type)

Parameter	Erklärung	Datentyp
output_type	The type of output features to count. The parameter should be set using the OriginDestinationCostMatrixOutputDataType enumeration.	Object

Rückgabewert

Datentyp	Erklärung
Integer	The number of rows.

Raises no exception.

export (output_type, output_features)

Parameter	Erklärung	Datentyp
output_type	The type of output to export. The parameter should be set using the OriginDestinationCostMatrixOutputDataType enumeration. See descriptions of the fields included in each output type	Object
output_features	The catalog path to the output feature class or table that will contain the exported features.	String

fieldNames (output_type)

Parameter	Erklärung	Datentyp
output_type	The type of output for which to return a list of field names. The parameter should be set using the OriginDestinationCostMatrixOutputDataType enumeration. See descriptions of the fields included in each output type	Object

Rückgabewert

Datentyp	Erklärung
String	A list of field names supported by the specified output type.

saveAsLayerFile (file_name)

Parameter	Erklärung	Datentyp
file_name	The catalog path of the output layer file (.lyr) or layer package (.lpkx) to write.	String

searchCursor (output_type, field_names, {where_clause})

Parameter	Erklärung	Datentyp
output_type	The type of output to read. The parameter should be set using the OriginDestinationCostMatrixOutputDataType enumeration.	Object
field_names [field_names,...]	A list of field names of the output type whose values the cursor will return. You can get the names of the fields that are supported by an output type using the fieldNames method. See descriptions of the fields included in each output type In addition to regular fields, you can also access the geometry of the output using one of the following geometry tokens: SHAPE@XY —A tuple of the feature's centroid x,y coordinates. SHAPE@XYZ —A tuple of the feature's centroid x,y,z coordinates. SHAPE@JSON — The Esri JSON string representing the geometry. SHAPE@WKB —The well-known binary (WKB) representation for OGC geometry. It provides a portable representation of a geometry value as a contiguous stream of bytes. SHAPE@WKT —The well-known text (WKT) representation for OGC geometry. It provides a portable representation of a geometry value as a text string. SHAPE@ —A geometry object for the feature. The SHAPE@XY and SHAPE@XYZ tokens are only supported for point-based output types. The x-, y-, and z-values returned when using the SHAPE@XY and SHAPE@XYZ tokens are in the spatial reference of the network data source used for the analysis.	String
where_clause	An optional expression that limits the records returned. For more information on WHERE clauses and SQL statements, see SQL reference for query expressions used in ArcGIS. (Der Standardwert ist None)	String

Rückgabewert

Datentyp	Erklärung
Object	A SolverResultSearchCursor object that reads rows from the output.

solverMessages (severity)

Parameter	Erklärung	Datentyp
severity	The type of messages to be returned. The parameter should be specified using the MessageSeverity enumeration.	Object

Rückgabewert

Datentyp

Erklärung

List

The messages are returned as a list of lists. The inner list contains two values; the first is a number representing the message code, and the second value is the message text. An example of a list of messages returned from a failed origin destination cost matrix analysis. [[-2147200995, '0 location(s) in "Destinations" are valid. Need at least 1 valid location(s).'], [30024, 'Solve returned a failure.'], [-2147200995, 'Insufficient number of valid locations in "Origins" or "Destinations".']]