TerrainSpeed Structure
Represents a terrain type and the corresponding speed of a vehicle.
NuGet/Assembly: Carmenta.Engine.5.16.2.nupkg (in the CEOperators assembly)
Syntax
public sealed class TerrainSpeed : EngineValueTypeRemarks
A collection of TerrainSpeed instances is used to specify how fast a TerrainVehicleType can go in various types of terrain. Each TerrainSpeed instance defines a terrain type and the corresponding speed in normal weather: there is no snow, the ground is not frozen, etc.
The Speed is given in km/hour; any speed that is 0.5 km/hour or less will be treated as zero.
The terrain type is defined by the three properties GroundCondition (soil strength), SurfaceStructure (roughness) and Slope. Each of them is an integer in the range 1 to 5, with the following code:
GroundCondition | SurfaceStructure | Slope | |
|---|---|---|---|
1 | very strong | very even | 0 – 10% |
2 | strong | even | 10 – 20% |
3 | average | somewhat uneven | 20 – 33% |
4 | weak | uneven | 33 – 50% |
5 | very weak | very uneven | more than 50% |
This scheme has been developed jointly by the Swedish Army and the Swedish forestry industry. Briefly, the GroundCondition can be estimated from soil type and either forest type or soil moisture and humidity. The SurfaceStructure depends on the frequency and heights of rocks, boulders, soil mounds and cavities. The Slope should be measured over a horizontal distance of 25 meters; the vehicle is assumed to go straight up or down the slope, not sideways. We assume that the speed is the same uphill as downhill.
Since each of the three terrain factors can take one of 5 values, there are 5 * 5 * 5 = 125 possible terrain types. No terrain type may appear more than once in a TerrainVehicleType.LandSpeeds collection. You can omit terrain types in which the speed would be zero.
The speed must decrease or stay the same when a terrain factor is made harder. That is, if there are two collection entries TS1 and TS2, with TS1.GroundCondition ≤ TS2.GroundCondition, TS1.SurfaceStructure ≤ TS2.SurfaceStructure, and TS1.Slope ≤ TS2.Slope, then the terrain type defined by TS2 is at least as difficult as the one defined by TS1, so it must be that TS1.Speed ≥ TS2.Speed.
For more background, and an example GUI for editing terrain speeds in an application, see Terrain Vehicle Analysis.
Inheritance Hierarchy
System.Object (not available in C#)
EngineValueType
TerrainSpeed
Platforms
Windows, Linux, Android
See Also
Reference
Operators Module
TerrainAccessOperator
TerrainRouteOperator
TerrainSpeedOperator
TerrainVehicleType
Terrain Vehicle Analysis
TerrainSpeed Members
The TerrainSpeed type has the following members.
Constructors
| Name | Description |
|---|---|
| TerrainSpeed | Initializes a new instance of the TerrainSpeed class. |
Properties
| Name | Description |
|---|---|
| GroundCondition | Gets the ground condition class (the soil strength). |
| Slope | Gets the slope class. |
| Speed | Gets the speed in km/hour in the given ground condition, surface structure and slope classes. |
| SurfaceStructure | Gets the surface structure class (the roughness). |
Methods
| Name | Description |
|---|---|
| Equals | Overloaded. Determines whether two TerrainSpeed objects have the same value. |
| GetHashCode | Returns the hash code for this TerrainSpeed. |
 Operator == | Determines whether two specified TerrainSpeed objects have the same value. |
| Operator != | Determines whether two specified TerrainSpeed objects have different values. |
| ToString | Converts this TerrainSpeed to a human readable string. |