update doc ref #2 #15980

Signed-off-by: m-kro <[email protected]>

docs/web/docs/Simulation/Stationfinder.md

@@ -38,14 +38,15 @@ The parameters take effect only on vehicles which have been assigned a stationfi
 | chargingStrategy      | string           | {balanced; latest; none}    | none             | Chosen charging strategy (`balanced` will spread the charging across the whole stopping duration, `latest` will shift charging towards the end of the stopping duration) |
 | opportunisticChargeLevel | float         | [0;1]                     | 0                | State of charge below which the vehicle wants to charge nearby planned stops (on the same edge as the planned stop) although not needed to complete its route (named opportunistic charging) |
 | minOpportunityDuration | float (s)       | ≥0                        | 3600             | The minimum expected duration of a planned stop to be used for opportunistic charging |
+| checkEnergyForRoute   | bool             | {true; false}             | false            | Check whether the current battery charge may be enough to complete the route and thus skip searching for charging stations |
 
 ## Decision logic for charging
 
 This paragraph shall convey the major conditions used in the decision logic of the device. The device has to decide whether and where to reroute the
 vehicle to charge. The user can configure multiple thresholds to change how different vehicles behave.
 
 - As long as the battery state of charge (SoC) is above `needToChargeLevel`, no action is taken. This condition is rechecked each time the SoC has lowered by 10%.
-- If the stationfinder device estimates the battery charge is still sufficient to reach the destination and keep at least the `emptyThreshold` state of charge, then no action is taken.
+- If the stationfinder device estimates the battery charge is still sufficient to reach the destination and keep at least the `emptyThreshold` state of charge, then no action is taken. This check can be deactivated by setting `checkEnergyForRoute` to `false`.
 - When the SoC reaches `needToChargeLevel`, possible charging stations are searched and evaluated using the [target function](#charging_station_target_function). Only charging stations offering the right charging type (such as charging the vehicle battery) are considered valid destinations. If the destination can presumably still be reached with the current SoC and without using the SoC below `emptyThreshold` then no charging station is targeted. If a valid charging station is found within `radius` travel time (and optionally within `maxEuclideanDistance` air line), the vehicle is immediately rerouted to go there. Other programmed stops will be served after charging.
 - If no charging station is available, the vehicle continues its original route. It will search again after `repeat` seconds.
 - If the charging station is occupied on arrival, the vehicle will wait `waitForCharge` seconds before looking for an alternative site.
@@ -136,7 +137,7 @@ The internal state of the stationfinder device can be accessed directly using
 and
 [*traci.vehicle.setParameter*](../TraCI/Change_Vehicle_State.md#supported_device_parameters).
 
-Some of the device parameters explained above and more **read-only** properties are available (Note that you need to supply the full name `device.stationfinder.<PARAMETER NAME>` to 
+Some of the device parameters explained above and more **read-only** properties are available (Note that you need to supply the full name `device.stationfinder.<PARAMETER NAME>` to
 the TraCI function):
 
 | Parameter             | Get             | Set               | Description                                                                         |
@@ -149,5 +150,3 @@ the TraCI function):
 | repeat                | yes             | yes               | See [above](#configuration)                                                         |
 | radius                | yes             | yes               | See [above](#configuration)                                                         |
 | reserveFactor         | yes             | yes               | See [above](#configuration)                                                         |
-
-