Kinetica C# API  Version 7.1.10.0
 All Classes Namespaces Files Functions Variables Enumerations Enumerator Properties Pages
kinetica.MatchGraphRequest.Options Struct Reference

Additional parameters

More...

Public Attributes

const string GPS_NOISE = "gps_noise"
 GPS noise value (in meters) to remove redundant sample points. More...
 
const string NUM_SEGMENTS = "num_segments"
 Maximum number of potentially matching road segments for each sample point. More...
 
const string SEARCH_RADIUS = "search_radius"
 Maximum search radius used when snapping sample points onto potentially matching surrounding segments. More...
 
const string CHAIN_WIDTH = "chain_width"
 For the markov_chain solver only. More...
 
const string SOURCE = "source"
 Optional WKT starting point from sample_points for the solver. More...
 
const string DESTINATION = "destination"
 Optional WKT ending point from sample_points for the solver. More...
 
const string PARTIAL_LOADING = "partial_loading"
 For the match_supply_demand solver only. More...
 
const string TRUE = "true"
 
const string FALSE = "false"
 
const string MAX_COMBINATIONS = "max_combinations"
 For the match_supply_demand solver only. More...
 
const string MAX_SUPPLY_COMBINATIONS = "max_supply_combinations"
 For the match_supply_demand solver only. More...
 
const string LEFT_TURN_PENALTY = "left_turn_penalty"
 This will add an additonal weight over the edges labelled as 'left turn' if the 'add_turn' option parameter of the Kinetica.createGraph(string,bool,IList{string},IList{string},IList{string},IList{string},IDictionary{string, string}) was invoked at graph creation. More...
 
const string RIGHT_TURN_PENALTY = "right_turn_penalty"
 This will add an additonal weight over the edges labelled as' right turn' if the 'add_turn' option parameter of the Kinetica.createGraph(string,bool,IList{string},IList{string},IList{string},IList{string},IDictionary{string, string}) was invoked at graph creation. More...
 
const string INTERSECTION_PENALTY = "intersection_penalty"
 This will add an additonal weight over the edges labelled as 'intersection' if the 'add_turn' option parameter of the Kinetica.createGraph(string,bool,IList{string},IList{string},IList{string},IList{string},IDictionary{string, string}) was invoked at graph creation. More...
 
const string SHARP_TURN_PENALTY = "sharp_turn_penalty"
 This will add an additonal weight over the edges labelled as 'sharp turn' or 'u-turn' if the 'add_turn' option parameter of the Kinetica.createGraph(string,bool,IList{string},IList{string},IList{string},IList{string},IDictionary{string, string}) was invoked at graph creation. More...
 
const string AGGREGATED_OUTPUT = "aggregated_output"
 For the match_supply_demand solver only. More...
 
const string OUTPUT_TRACKS = "output_tracks"
 For the match_supply_demand solver only. More...
 
const string MAX_TRIP_COST = "max_trip_cost"
 For the match_supply_demand and match_pickup_dropoff solvers only. More...
 
const string FILTER_FOLDING_PATHS = "filter_folding_paths"
 For the markov_chain solver only. More...
 
const string UNIT_UNLOADING_COST = "unit_unloading_cost"
 For the match_supply_demand solver only. More...
 
const string MAX_NUM_THREADS = "max_num_threads"
 For the markov_chain solver only. More...
 
const string SERVICE_LIMIT = "service_limit"
 For the match_supply_demand solver only. More...
 
const string ENABLE_REUSE = "enable_reuse"
 For the match_supply_demand solver only. More...
 
const string MAX_STOPS = "max_stops"
 For the match_supply_demand solver only. More...
 
const string SERVICE_RADIUS = "service_radius"
 For the match_supply_demand and match_pickup_dropoff solvers only. More...
 
const string PERMUTE_SUPPLIES = "permute_supplies"
 For the match_supply_demand solver only. More...
 
const string BATCH_TSM_MODE = "batch_tsm_mode"
 For the match_supply_demand solver only. More...
 
const string ROUND_TRIP = "round_trip"
 For the match_supply_demand solver only. More...
 
const string NUM_CYCLES = "num_cycles"
 For the match_clusters solver only. More...
 
const string NUM_LOOPS_PER_CYCLE = "num_loops_per_cycle"
 For the match_clusters solver only. More...
 
const string NUM_OUTPUT_CLUSTERS = "num_output_clusters"
 For the match_clusters solver only. More...
 
const string MAX_NUM_CLUSTERS = "max_num_clusters"
 For the match_clusters solver only. More...
 
const string CLUSTER_QUALITY_METRIC = "cluster_quality_metric"
 For the match_clusters solver only. More...
 
const string GIRVAN = "girvan"
 Uses the Newman Girvan quality metric for cluster solver More...
 
const string SPECTRAL = "spectral"
 Applies recursive spectral bisection (RSB) partitioning solver More...
 
const string RESTRICTED_TYPE = "restricted_type"
 For the match_supply_demand solver only. More...
 
const string ODD = "odd"
 Applies odd/even rule restrictions to odd tagged vehicles. More...
 
const string EVEN = "even"
 Applies odd/even rule restrictions to even tagged vehicles. More...
 
const string NONE = "none"
 Does not apply odd/even rule restrictions to any vehicles. More...
 
const string SERVER_ID = "server_id"
 Indicates which graph server(s) to send the request to. More...
 
const string INVERSE_SOLVE = "inverse_solve"
 For the match_batch_solves solver only. More...
 
const string MIN_LOOP_LEVEL = "min_loop_level"
 For the match_loops solver only. More...
 
const string MAX_LOOP_LEVEL = "max_loop_level"
 For the match_loops solver only. More...
 
const string SEARCH_LIMIT = "search_limit"
 For the match_loops solver only. More...
 
const string OUTPUT_BATCH_SIZE = "output_batch_size"
 For the match_loops solver only. More...
 
const string CHARGING_CAPACITY = "charging_capacity"
 For the match_charging_stations solver only. More...
 
const string CHARGING_CANDIDATES = "charging_candidates"
 For the match_charging_stations solver only. More...
 
const string CHARGING_PENALTY = "charging_penalty"
 For the match_charging_stations solver only. More...
 
const string MAX_HOPS = "max_hops"
 For the match_similarity solver only. More...
 
const string TRAVERSAL_NODE_LIMIT = "traversal_node_limit"
 For the match_similarity solver only. More...
 
const string PAIRED_SIMILARITY = "paired_similarity"
 For the match_similarity solver only. More...
 
const string FORCE_UNDIRECTED = "force_undirected"
 For the match_pattern solver only. More...
 

Detailed Description

Additional parameters

  • GPS_NOISE: GPS noise value (in meters) to remove redundant sample points.

Use -1 to disable noise reduction. The default value accounts for 95% of point variation (+ or -5 meters). The default value is '5.0'. NUM_SEGMENTS: Maximum number of potentially matching road segments for each sample point. For the markov_chain solver, the default is 3. The default value is '3'. SEARCH_RADIUS: Maximum search radius used when snapping sample points onto potentially matching surrounding segments. The default value corresponds to approximately 100 meters. The default value is '0.001'. CHAIN_WIDTH: For the markov_chain solver only. Length of the sample points lookahead window within the Markov kernel; the larger the number, the more accurate the solution. The default value is '9'. SOURCE: Optional WKT starting point from for the solver. The default behavior for the endpoint is to use time to determine the starting point. The default value is 'POINT NULL'. DESTINATION: Optional WKT ending point from for the solver. The default behavior for the endpoint is to use time to determine the destination point. The default value is 'POINT NULL'. PARTIAL_LOADING: For the match_supply_demand solver only. When false (non-default), trucks do not off-load at the demand (store) side if the remainder is less than the store's need Supported values:

  • TRUE: Partial off-loading at multiple store (demand) locations
  • FALSE: No partial off-loading allowed if supply is less than the store's demand.

The default value is TRUE. MAX_COMBINATIONS: For the match_supply_demand solver only. This is the cutoff for the number of generated combinations for sequencing the demand locations - can increase this up to 2M. The default value is '10000'. MAX_SUPPLY_COMBINATIONS: For the match_supply_demand solver only. This is the cutoff for the number of generated combinations for sequencing the supply locations if/when 'permute_supplies' is true. The default value is '10000'. LEFT_TURN_PENALTY: This will add an additonal weight over the edges labelled as 'left turn' if the 'add_turn' option parameter of the /create/graph was invoked at graph creation. The default value is '0.0'. RIGHT_TURN_PENALTY: This will add an additonal weight over the edges labelled as' right turn' if the 'add_turn' option parameter of the /create/graph was invoked at graph creation. The default value is '0.0'. INTERSECTION_PENALTY: This will add an additonal weight over the edges labelled as 'intersection' if the 'add_turn' option parameter of the /create/graph was invoked at graph creation. The default value is '0.0'. SHARP_TURN_PENALTY: This will add an additonal weight over the edges labelled as 'sharp turn' or 'u-turn' if the 'add_turn' option parameter of the /create/graph was invoked at graph creation. The default value is '0.0'. AGGREGATED_OUTPUT: For the match_supply_demand solver only. When it is true (default), each record in the output table shows a particular truck's scheduled cumulative round trip path (MULTILINESTRING) and the corresponding aggregated cost. Otherwise, each record shows a single scheduled truck route (LINESTRING) towards a particular demand location (store id) with its corresponding cost. The default value is 'true'. OUTPUT_TRACKS: For the match_supply_demand solver only. When it is true (non-default), the output will be in tracks format for all the round trips of each truck in which the timestamps are populated directly from the edge weights starting from their originating depots. The default value is 'false'. MAX_TRIP_COST: For the match_supply_demand and match_pickup_dropoff solvers only. If this constraint is greater than zero (default) then the trucks/rides will skip travelling from one demand/pick location to another if the cost between them is greater than this number (distance or time). Zero (default) value means no check is performed. The default value is '0.0'. FILTER_FOLDING_PATHS: For the markov_chain solver only. When true (non-default), the paths per sequence combination is checked for folding over patterns and can significantly increase the execution time depending on the chain width and the number of gps samples. Supported values:

  • TRUE: Filter out the folded paths.
  • FALSE: Do not filter out the folded paths

The default value is FALSE. UNIT_UNLOADING_COST: For the match_supply_demand solver only. The unit cost per load amount to be delivered. If this value is greater than zero (default) then the additional cost of this unit load multiplied by the total dropped load will be added over to the trip cost to the demand location. The default value is '0.0'. MAX_NUM_THREADS: For the markov_chain solver only. If specified (greater than zero), the maximum number of threads will not be greater than the specified value. It can be lower due to the memory and the number cores available. Default value of zero allows the algorithm to set the maximal number of threads within these constraints. The default value is '0'. SERVICE_LIMIT: For the match_supply_demand solver only. If specified (greater than zero), any supply actor's total service cost (distance or time) will be limited by the specified value including multiple rounds (if set). The default value is '0.0'. ENABLE_REUSE: For the match_supply_demand solver only. If specified (true), all supply actors can be scheduled for second rounds from their originating depots. Supported values:

  • TRUE: Allows reusing supply actors (trucks, e.g.) for scheduling again.
  • FALSE: Supply actors are scheduled only once from their depots.

The default value is FALSE. MAX_STOPS: For the match_supply_demand solver only. If specified (greater than zero), a supply actor (truck) can at most have this many stops (demand locations) in one round trip. Otherwise, it is unlimited. If 'enable_truck_reuse' is on, this condition will be applied separately at each round trip use of the same truck. The default value is '0'. SERVICE_RADIUS: For the match_supply_demand and match_pickup_dropoff solvers only. If specified (greater than zero), it filters the demands/picks outside this radius centered around the supply actor/ride's originating location (distance or time). The default value is '0.0'. PERMUTE_SUPPLIES: For the match_supply_demand solver only. If specified (true), supply side actors are permuted for the demand combinations during msdo optimization - note that this option increases optimization time significantly - use of 'max_combinations' option is recommended to prevent prohibitively long runs Supported values:

  • TRUE: Generates sequences over supply side permutations if total supply is less than twice the total demand
  • FALSE: Permutations are not performed, rather a specific order of supplies based on capacity is computed

The default value is TRUE. BATCH_TSM_MODE: For the match_supply_demand solver only. When enabled, it sets the number of visits on each demand location by a single salesman at each trip is considered to be (one) 1, otherwise there is no bound. Supported values:

  • TRUE: Sets only one visit per demand location by a salesman (tsm mode)
  • FALSE: No preset limit (usual msdo mode)

The default value is FALSE. ROUND_TRIP: For the match_supply_demand solver only. When enabled, the supply will have to return back to the origination location. Supported values:

  • TRUE: The optimization is done for trips in round trip manner always returning to originating locations
  • FALSE: Supplies do not have to come back to their originating locations in their routes. The routes are considered finished at the final dropoff.

The default value is TRUE. NUM_CYCLES: For the match_clusters solver only. Terminates the cluster exchange iterations across 2-step-cycles (outer loop) when quality does not improve during iterations. The default value is '10'. NUM_LOOPS_PER_CYCLE: For the match_clusters solver only. Terminates the cluster exchanges within the first step iterations of a cycle (inner loop) unless convergence is reached. The default value is '10'. NUM_OUTPUT_CLUSTERS: For the match_clusters solver only. Limits the output to the top 'num_output_clusters' clusters based on density. Default value of zero outputs all clusters. The default value is '0'. MAX_NUM_CLUSTERS: For the match_clusters solver only. If set (value greater than zero), it terminates when the number of clusters goes below than this number. The default value is '0'. CLUSTER_QUALITY_METRIC: For the match_clusters solver only. The quality metric for Louvain modularity optimization solver. Supported values:

  • GIRVAN: Uses the Newman Girvan quality metric for cluster solver
  • SPECTRAL: Applies recursive spectral bisection (RSB) partitioning solver

The default value is GIRVAN. RESTRICTED_TYPE: For the match_supply_demand solver only. Optimization is performed by restricting routes labeled by 'MSDO_ODDEVEN_RESTRICTED' only for this supply actor (truck) type Supported values:

  • ODD: Applies odd/even rule restrictions to odd tagged vehicles.
  • EVEN: Applies odd/even rule restrictions to even tagged vehicles.
  • NONE: Does not apply odd/even rule restrictions to any vehicles.

The default value is NONE. SERVER_ID: Indicates which graph server(s) to send the request to. Default is to send to the server, amongst those containing the corresponding graph, that has the most computational bandwidth. The default value is ''. INVERSE_SOLVE: For the match_batch_solves solver only. Solves source-destination pairs using inverse shortest path solver. Supported values:

  • TRUE: Solves using inverse shortest path solver.
  • FALSE: Solves using direct shortest path solver.

The default value is FALSE. MIN_LOOP_LEVEL: For the match_loops solver only. Finds closed loops around each node deducible not less than this minimal hop (level) deep. The default value is '0'. MAX_LOOP_LEVEL: For the match_loops solver only. Finds closed loops around each node deducible not more than this maximal hop (level) deep. The default value is '5'. SEARCH_LIMIT: For the match_loops solver only. Searches within this limit of nodes per vertex to detect loops. The value zero means there is no limit. The default value is '10000'. OUTPUT_BATCH_SIZE: For the match_loops solver only. Uses this value as the batch size of the number of loops in flushing(inserting) to the output table. The default value is '1000'. CHARGING_CAPACITY: For the match_charging_stations solver only. This is the maximum ev-charging capacity of a vehicle (distance in meters or time in seconds depending on the unit of the graph weights). The default value is '300000.0'. CHARGING_CANDIDATES: For the match_charging_stations solver only. Solver searches for this many number of stations closest around each base charging location found by capacity. The default value is '10'. CHARGING_PENALTY: For the match_charging_stations solver only. This is the penalty for full charging. The default value is '30000.0'. MAX_HOPS: For the match_similarity solver only. Searches within this maximum hops for source and target node pairs to compute the Jaccard scores. The default value is '3'. TRAVERSAL_NODE_LIMIT: For the match_similarity solver only. Limits the traversal depth if it reaches this many number of nodes. The default value is '1000'. PAIRED_SIMILARITY: For the match_similarity solver only. If true, it computes Jaccard score between each pair, otherwise it will compute Jaccard from the intersection set between the source and target nodes Supported values:

The default value is TRUE. FORCE_UNDIRECTED: For the match_pattern solver only. Pattern matching will be using both pattern and graph as undirected if set to true. Supported values:

The default value is FALSE.

The default value is an empty Dictionary. A set of string constants for the parameter options.

Definition at line 736 of file MatchGraph.cs.

Member Data Documentation

const string kinetica.MatchGraphRequest.Options.AGGREGATED_OUTPUT = "aggregated_output"

For the match_supply_demand solver only.

When it is true (default), each record in the output table shows a particular truck's scheduled cumulative round trip path (MULTILINESTRING) and the corresponding aggregated cost. Otherwise, each record shows a single scheduled truck route (LINESTRING) towards a particular demand location (store id) with its corresponding cost. The default value is 'true'.

Definition at line 850 of file MatchGraph.cs.

const string kinetica.MatchGraphRequest.Options.BATCH_TSM_MODE = "batch_tsm_mode"

For the match_supply_demand solver only.

When enabled, it sets the number of visits on each demand location by a single salesman at each trip is considered to be (one) 1, otherwise there is no bound. Supported values:

  • TRUE: Sets only one visit per demand location by a salesman (tsm mode)
  • FALSE: No preset limit (usual msdo mode)

The default value is FALSE.

Definition at line 1000 of file MatchGraph.cs.

const string kinetica.MatchGraphRequest.Options.CHAIN_WIDTH = "chain_width"

For the markov_chain solver only.

Length of the sample points lookahead window within the Markov kernel; the larger the number, the more accurate the solution. The default value is '9'.

Definition at line 760 of file MatchGraph.cs.

const string kinetica.MatchGraphRequest.Options.CHARGING_CANDIDATES = "charging_candidates"

For the match_charging_stations solver only.

Solver searches for this many number of stations closest around each base charging location found by capacity. The default value is '10'.

Definition at line 1179 of file MatchGraph.cs.

const string kinetica.MatchGraphRequest.Options.CHARGING_CAPACITY = "charging_capacity"

For the match_charging_stations solver only.

This is the maximum ev-charging capacity of a vehicle (distance in meters or time in seconds depending on the unit of the graph weights). The default value is '300000.0'.

Definition at line 1173 of file MatchGraph.cs.

const string kinetica.MatchGraphRequest.Options.CHARGING_PENALTY = "charging_penalty"

For the match_charging_stations solver only.

This is the penalty for full charging. The default value is '30000.0'.

Definition at line 1184 of file MatchGraph.cs.

const string kinetica.MatchGraphRequest.Options.CLUSTER_QUALITY_METRIC = "cluster_quality_metric"

For the match_clusters solver only.

The quality metric for Louvain modularity optimization solver. Supported values:

  • GIRVAN: Uses the Newman Girvan quality metric for cluster solver
  • SPECTRAL: Applies recursive spectral bisection (RSB) partitioning solver

The default value is GIRVAN.

Definition at line 1069 of file MatchGraph.cs.

const string kinetica.MatchGraphRequest.Options.DESTINATION = "destination"

Optional WKT ending point from sample_points for the solver.

The default behavior for the endpoint is to use time to determine the destination point. The default value is 'POINT NULL'.

Definition at line 772 of file MatchGraph.cs.

const string kinetica.MatchGraphRequest.Options.ENABLE_REUSE = "enable_reuse"

For the match_supply_demand solver only.

If specified (true), all supply actors can be scheduled for second rounds from their originating depots. Supported values:

  • TRUE: Allows reusing supply actors (trucks, e.g.) for scheduling again.
  • FALSE: Supply actors are scheduled only once from their depots.

The default value is FALSE.

Definition at line 935 of file MatchGraph.cs.

const string kinetica.MatchGraphRequest.Options.EVEN = "even"

Applies odd/even rule restrictions to even tagged vehicles.

Definition at line 1114 of file MatchGraph.cs.

const string kinetica.MatchGraphRequest.Options.FALSE = "false"

Definition at line 796 of file MatchGraph.cs.

const string kinetica.MatchGraphRequest.Options.FILTER_FOLDING_PATHS = "filter_folding_paths"

For the markov_chain solver only.

When true (non-default), the paths per sequence combination is checked for folding over patterns and can significantly increase the execution time depending on the chain width and the number of gps samples. Supported values:

  • TRUE: Filter out the folded paths.
  • FALSE: Do not filter out the folded paths

The default value is FALSE.

Definition at line 890 of file MatchGraph.cs.

const string kinetica.MatchGraphRequest.Options.FORCE_UNDIRECTED = "force_undirected"

For the match_pattern solver only.

Pattern matching will be using both pattern and graph as undirected if set to true. Supported values:

The default value is FALSE.

Definition at line 1232 of file MatchGraph.cs.

const string kinetica.MatchGraphRequest.Options.GIRVAN = "girvan"

Uses the Newman Girvan quality metric for cluster solver

Definition at line 1073 of file MatchGraph.cs.

const string kinetica.MatchGraphRequest.Options.GPS_NOISE = "gps_noise"

GPS noise value (in meters) to remove redundant sample points.

Use -1 to disable noise reduction. The default value accounts for 95% of point variation (+ or -5 meters). The default value is '5.0'.

Definition at line 743 of file MatchGraph.cs.

const string kinetica.MatchGraphRequest.Options.INTERSECTION_PENALTY = "intersection_penalty"

This will add an additonal weight over the edges labelled as 'intersection' if the 'add_turn' option parameter of the Kinetica.createGraph(string,bool,IList{string},IList{string},IList{string},IList{string},IDictionary{string, string}) was invoked at graph creation.

The default value is '0.0'.

Definition at line 832 of file MatchGraph.cs.

const string kinetica.MatchGraphRequest.Options.INVERSE_SOLVE = "inverse_solve"

For the match_batch_solves solver only.

Solves source-destination pairs using inverse shortest path solver. Supported values:

  • TRUE: Solves using inverse shortest path solver.
  • FALSE: Solves using direct shortest path solver.

The default value is FALSE.

Definition at line 1145 of file MatchGraph.cs.

const string kinetica.MatchGraphRequest.Options.LEFT_TURN_PENALTY = "left_turn_penalty"

This will add an additonal weight over the edges labelled as 'left turn' if the 'add_turn' option parameter of the Kinetica.createGraph(string,bool,IList{string},IList{string},IList{string},IList{string},IDictionary{string, string}) was invoked at graph creation.

The default value is '0.0'.

Definition at line 816 of file MatchGraph.cs.

const string kinetica.MatchGraphRequest.Options.MAX_COMBINATIONS = "max_combinations"

For the match_supply_demand solver only.

This is the cutoff for the number of generated combinations for sequencing the demand locations - can increase this up to 2M. The default value is '10000'.

Definition at line 802 of file MatchGraph.cs.

const string kinetica.MatchGraphRequest.Options.MAX_HOPS = "max_hops"

For the match_similarity solver only.

Searches within this maximum hops for source and target node pairs to compute the Jaccard scores. The default value is '3'.

Definition at line 1190 of file MatchGraph.cs.

const string kinetica.MatchGraphRequest.Options.MAX_LOOP_LEVEL = "max_loop_level"

For the match_loops solver only.

Finds closed loops around each node deducible not more than this maximal hop (level) deep. The default value is '5'.

Definition at line 1155 of file MatchGraph.cs.

const string kinetica.MatchGraphRequest.Options.MAX_NUM_CLUSTERS = "max_num_clusters"

For the match_clusters solver only.

If set (value greater than zero), it terminates when the number of clusters goes below than this number. The default value is '0'.

Definition at line 1048 of file MatchGraph.cs.

const string kinetica.MatchGraphRequest.Options.MAX_NUM_THREADS = "max_num_threads"

For the markov_chain solver only.

If specified (greater than zero), the maximum number of threads will not be greater than the specified value. It can be lower due to the memory and the number cores available. Default value of zero allows the algorithm to set the maximal number of threads within these constraints. The default value is '0'.

Definition at line 906 of file MatchGraph.cs.

const string kinetica.MatchGraphRequest.Options.MAX_STOPS = "max_stops"

For the match_supply_demand solver only.

If specified (greater than zero), a supply actor (truck) can at most have this many stops (demand locations) in one round trip. Otherwise, it is unlimited. If 'enable_truck_reuse' is on, this condition will be applied separately at each round trip use of the same truck. The default value is '0'.

Definition at line 943 of file MatchGraph.cs.

const string kinetica.MatchGraphRequest.Options.MAX_SUPPLY_COMBINATIONS = "max_supply_combinations"

For the match_supply_demand solver only.

This is the cutoff for the number of generated combinations for sequencing the supply locations if/when 'permute_supplies' is true. The default value is '10000'.

Definition at line 808 of file MatchGraph.cs.

const string kinetica.MatchGraphRequest.Options.MAX_TRIP_COST = "max_trip_cost"

For the match_supply_demand and match_pickup_dropoff solvers only.

If this constraint is greater than zero (default) then the trucks/rides will skip travelling from one demand/pick location to another if the cost between them is greater than this number (distance or time). Zero (default) value means no check is performed. The default value is '0.0'.

Definition at line 867 of file MatchGraph.cs.

const string kinetica.MatchGraphRequest.Options.MIN_LOOP_LEVEL = "min_loop_level"

For the match_loops solver only.

Finds closed loops around each node deducible not less than this minimal hop (level) deep. The default value is '0'.

Definition at line 1150 of file MatchGraph.cs.

const string kinetica.MatchGraphRequest.Options.NONE = "none"

Does not apply odd/even rule restrictions to any vehicles.

Definition at line 1118 of file MatchGraph.cs.

const string kinetica.MatchGraphRequest.Options.NUM_CYCLES = "num_cycles"

For the match_clusters solver only.

Terminates the cluster exchange iterations across 2-step-cycles (outer loop) when quality does not improve during iterations. The default value is '10'.

Definition at line 1030 of file MatchGraph.cs.

const string kinetica.MatchGraphRequest.Options.NUM_LOOPS_PER_CYCLE = "num_loops_per_cycle"

For the match_clusters solver only.

Terminates the cluster exchanges within the first step iterations of a cycle (inner loop) unless convergence is reached. The default value is '10'.

Definition at line 1036 of file MatchGraph.cs.

const string kinetica.MatchGraphRequest.Options.NUM_OUTPUT_CLUSTERS = "num_output_clusters"

For the match_clusters solver only.

Limits the output to the top 'num_output_clusters' clusters based on density. Default value of zero outputs all clusters. The default value is '0'.

Definition at line 1042 of file MatchGraph.cs.

const string kinetica.MatchGraphRequest.Options.NUM_SEGMENTS = "num_segments"

Maximum number of potentially matching road segments for each sample point.

For the markov_chain solver, the default is 3. The default value is '3'.

Definition at line 748 of file MatchGraph.cs.

const string kinetica.MatchGraphRequest.Options.ODD = "odd"

Applies odd/even rule restrictions to odd tagged vehicles.

Definition at line 1110 of file MatchGraph.cs.

const string kinetica.MatchGraphRequest.Options.OUTPUT_BATCH_SIZE = "output_batch_size"

For the match_loops solver only.

Uses this value as the batch size of the number of loops in flushing(inserting) to the output table. The default value is '1000'.

Definition at line 1167 of file MatchGraph.cs.

const string kinetica.MatchGraphRequest.Options.OUTPUT_TRACKS = "output_tracks"

For the match_supply_demand solver only.

When it is true (non-default), the output will be in tracks format for all the round trips of each truck in which the timestamps are populated directly from the edge weights starting from their originating depots. The default value is 'false'.

Definition at line 858 of file MatchGraph.cs.

const string kinetica.MatchGraphRequest.Options.PAIRED_SIMILARITY = "paired_similarity"

For the match_similarity solver only.

If true, it computes Jaccard score between each pair, otherwise it will compute Jaccard from the intersection set between the source and target nodes Supported values:

The default value is TRUE.

Definition at line 1214 of file MatchGraph.cs.

const string kinetica.MatchGraphRequest.Options.PARTIAL_LOADING = "partial_loading"

For the match_supply_demand solver only.

When false (non-default), trucks do not off-load at the demand (store) side if the remainder is less than the store's need Supported values:

  • TRUE: Partial off-loading at multiple store (demand) locations
  • FALSE: No partial off-loading allowed if supply is less than the store's demand.

The default value is TRUE.

Definition at line 794 of file MatchGraph.cs.

const string kinetica.MatchGraphRequest.Options.PERMUTE_SUPPLIES = "permute_supplies"

For the match_supply_demand solver only.

If specified (true), supply side actors are permuted for the demand combinations during msdo optimization - note that this option increases optimization time significantly - use of 'max_combinations' option is recommended to prevent prohibitively long runs Supported values:

  • TRUE: Generates sequences over supply side permutations if total supply is less than twice the total demand
  • FALSE: Permutations are not performed, rather a specific order of supplies based on capacity is computed

The default value is TRUE.

Definition at line 977 of file MatchGraph.cs.

const string kinetica.MatchGraphRequest.Options.RESTRICTED_TYPE = "restricted_type"

For the match_supply_demand solver only.

Optimization is performed by restricting routes labeled by 'MSDO_ODDEVEN_RESTRICTED' only for this supply actor (truck) type Supported values:

  • ODD: Applies odd/even rule restrictions to odd tagged vehicles.
  • EVEN: Applies odd/even rule restrictions to even tagged vehicles.
  • NONE: Does not apply odd/even rule restrictions to any vehicles.

The default value is NONE.

Definition at line 1106 of file MatchGraph.cs.

const string kinetica.MatchGraphRequest.Options.RIGHT_TURN_PENALTY = "right_turn_penalty"

This will add an additonal weight over the edges labelled as' right turn' if the 'add_turn' option parameter of the Kinetica.createGraph(string,bool,IList{string},IList{string},IList{string},IList{string},IDictionary{string, string}) was invoked at graph creation.

The default value is '0.0'.

Definition at line 824 of file MatchGraph.cs.

const string kinetica.MatchGraphRequest.Options.ROUND_TRIP = "round_trip"

For the match_supply_demand solver only.

When enabled, the supply will have to return back to the origination location. Supported values:

  • TRUE: The optimization is done for trips in round trip manner always returning to originating locations
  • FALSE: Supplies do not have to come back to their originating locations in their routes. The routes are considered finished at the final dropoff.

The default value is TRUE.

Definition at line 1024 of file MatchGraph.cs.

const string kinetica.MatchGraphRequest.Options.SEARCH_LIMIT = "search_limit"

For the match_loops solver only.

Searches within this limit of nodes per vertex to detect loops. The value zero means there is no limit. The default value is '10000'.

Definition at line 1161 of file MatchGraph.cs.

const string kinetica.MatchGraphRequest.Options.SEARCH_RADIUS = "search_radius"

Maximum search radius used when snapping sample points onto potentially matching surrounding segments.

The default value corresponds to approximately 100 meters. The default value is '0.001'.

Definition at line 754 of file MatchGraph.cs.

const string kinetica.MatchGraphRequest.Options.SERVER_ID = "server_id"

Indicates which graph server(s) to send the request to.

Default is to send to the server, amongst those containing the corresponding graph, that has the most computational bandwidth. The default value is ''.

Definition at line 1124 of file MatchGraph.cs.

const string kinetica.MatchGraphRequest.Options.SERVICE_LIMIT = "service_limit"

For the match_supply_demand solver only.

If specified (greater than zero), any supply actor's total service cost (distance or time) will be limited by the specified value including multiple rounds (if set). The default value is '0.0'.

Definition at line 913 of file MatchGraph.cs.

const string kinetica.MatchGraphRequest.Options.SERVICE_RADIUS = "service_radius"

For the match_supply_demand and match_pickup_dropoff solvers only.

If specified (greater than zero), it filters the demands/picks outside this radius centered around the supply actor/ride's originating location (distance or time). The default value is '0.0'.

Definition at line 950 of file MatchGraph.cs.

const string kinetica.MatchGraphRequest.Options.SHARP_TURN_PENALTY = "sharp_turn_penalty"

This will add an additonal weight over the edges labelled as 'sharp turn' or 'u-turn' if the 'add_turn' option parameter of the Kinetica.createGraph(string,bool,IList{string},IList{string},IList{string},IList{string},IDictionary{string, string}) was invoked at graph creation.

The default value is '0.0'.

Definition at line 840 of file MatchGraph.cs.

const string kinetica.MatchGraphRequest.Options.SOURCE = "source"

Optional WKT starting point from sample_points for the solver.

The default behavior for the endpoint is to use time to determine the starting point. The default value is 'POINT NULL'.

Definition at line 766 of file MatchGraph.cs.

const string kinetica.MatchGraphRequest.Options.SPECTRAL = "spectral"

Applies recursive spectral bisection (RSB) partitioning solver

Definition at line 1077 of file MatchGraph.cs.

const string kinetica.MatchGraphRequest.Options.TRAVERSAL_NODE_LIMIT = "traversal_node_limit"

For the match_similarity solver only.

Limits the traversal depth if it reaches this many number of nodes. The default value is '1000'.

Definition at line 1195 of file MatchGraph.cs.

const string kinetica.MatchGraphRequest.Options.TRUE = "true"

Definition at line 795 of file MatchGraph.cs.

const string kinetica.MatchGraphRequest.Options.UNIT_UNLOADING_COST = "unit_unloading_cost"

For the match_supply_demand solver only.

The unit cost per load amount to be delivered. If this value is greater than zero (default) then the additional cost of this unit load multiplied by the total dropped load will be added over to the trip cost to the demand location. The default value is '0.0'.

Definition at line 898 of file MatchGraph.cs.


The documentation for this struct was generated from the following file: