Automatic merge of T1.5.1-913-g91804456c and 16 pull requests

- Pull request #570 at 3539862: Experimental glTF 2.0 support with PBR lighting
- Pull request #839 at d00beb9: First phase of https://blueprints.launchpad.net/or/+spec/additional-cruise-control-parameters
- Pull request #876 at f92de76: docs: add source for documents previously on website to source Documentation folder
- Pull request #882 at a057eff: Blueprint/train car operations UI window
- Pull request #886 at 6c0785b: Scene viewer extension to TrackViewer
- Pull request #892 at 1f5ba4c: Signal Function OPP_SIG_ID_TRAINPATH
- Pull request #896 at 5866028: First implementation of https://blueprints.launchpad.net/or/+spec/specific-sounds-for-ai-trains
- Pull request #903 at 9bead33: Downloading route content (Github, zip)
- Pull request #910 at 97d4569: Allow building code using .NET 6 (Windows)
- Pull request #911 at 6834af0: docs: Add refactoring as a special type of PR
- Pull request #912 at f7b85e4: New Triple Valve Features Vol. 2
- Pull request #919 at e6c08a2: Added mouse wheel support for controls which can be moved by pressing t…
- Pull request #920 at a94e403: Update RailDriver in Manual
- Pull request #923 at e0f3c55: Add curve squeal to route
- Pull request #924 at 6c2c3cd: Default Asset Improvements
- Pull request #925 at e3b1688: Fix brakeshoe force bug

Author: openrails-bot

Source/Orts.Simulation/Simulation/RollingStocks/TrainCar.cs

@@ -734,6 +734,18 @@ public virtual void Initialize()
             BrakeSystem.Initialize();
             CurveSpeedDependent = Simulator.Settings.CurveSpeedDependent;
 
+            // Check Brake Shoe Friction parameters
+            if (BrakeShoeType == BrakeShoeTypes.Cast_Iron_P10 || BrakeShoeType == BrakeShoeTypes.Cast_Iron_P6 || BrakeShoeType == BrakeShoeTypes.High_Friction_Composite || BrakeShoeType == BrakeShoeTypes.Disc_Pads)
+            {
+                float NewtonsTokNewtons = 0.001f;
+                float maxBrakeShoeForcekN = NewtonsTokNewtons * MaxBrakeShoeForceN / NumberCarBrakeShoes;
+
+                if (maxBrakeShoeForcekN > 21 && Simulator.Settings.VerboseConfigurationMessages)
+                {
+                    Trace.TraceInformation("Maximum force per brakeshoe is {0} and has exceeded {1}, check MaxBrakeShoeForceN {2} or NumberCarBrakeShoes {3}",  FormatStrings.FormatForce(maxBrakeShoeForcekN * 1000, IsMetric), FormatStrings.FormatForce(20 * 1000, IsMetric), FormatStrings.FormatForce(MaxBrakeShoeForceN, IsMetric), NumberCarBrakeShoes);
+                }
+            } 
+            
             //CurveForceFilter.Initialize();
 
             // Initialize tunnel resistance values
@@ -3442,6 +3454,10 @@ public float KarwatzkiBrakeShoeFriction ( float k1, float k2, float k3, float k4
                 var friction = 0.0f;
                 float NewtonsTokNewtons = 0.001f;
                 float brakeShoeForcekN = NewtonsTokNewtons * BrakeShoeForceN / NumberCarBrakeShoes;
+            if (brakeShoeForcekN > 22.5) // Make sure that brake shoe force doesn't exceed 22.5 as it will cause a -ve brakeshoe CoF
+            {
+                brakeShoeForcekN = 21;
+            }
                 friction = k1 * ((brakeShoeForcekN + k2) / (brakeShoeForcekN + k3)) * ((MpS.ToKpH(AbsSpeedMpS) + k4) / (MpS.ToKpH(AbsSpeedMpS) + k5));
 
                 return friction;