Skip to content

Track profiles to enable super-elevation with Norbert Rieger's USTracks in Open Rails.

License

Notifications You must be signed in to change notification settings

pgroenbaek/ustracks-stf-profiles

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

21 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

USTracks STF Profiles

These track profiles allow use of the super-elevation feature in Open Rails together with Norbert Rieger's USTracks. They mimic the original USTracks shapes as best as possible.

If you wish to replace dynamic tracks within a route and/or generate new track shapes, you should instead use the DPP profiles provided by Norbert with Dynatrax.

Installation

This repository only contains the track profiles. The textures for USTracks can be obtained from the DBTracks package.

If you ever need these profiles for super-elevation the textures most likely are in the route already.

NOTE: Use of multiple profiles is only supported from testing version T1.5.1-1390 onwards.

Open Rails testing version T1.5.1-1390 onwards:

  1. Download and extract the latest release.

  2. Copy all the track profiles from the TrackProfiles folder.

  3. Place all of them into the <route folder>/TrackProfiles folder.

Open Rails will now automatically generate super-elevated track based on the type of USTracks sections used in the route.

Usage

The profiles are already configured to match USTracks variant based on the US prefixes of the shape file names.

If you have track shapes named anything else, additional match conditions can be added using the IncludeShapes parameter within each track profile file. You can also use the ExcludedShapes parameter if necessary.

About Dynatrax generated track sections:

Per default dynatrax generated tracks sections are not super-elevated properly unless additional TrackSection and TrackShape entries are added to the tsection.dat. The best way to do this is using a route-specific tsection.dat extension.

This can be very time-consuming to create by hand if there are many Dynatrax generated track sections in the route.

A fast way to create the extra tsection.dat for your route is using this python script. It will look through the world files and your local tsection.dat, and then create the extension tsection.dat with all the extra entries needed. The script needs to be configured with the correct paths but otherwise it is capable of creating the file for any route.

To use a specific track variant for a Dynatrax generated track section you can rename the shape file name to include the USTracks prefix. For example from Dynatrax-40892.s to US3r_Dynatrax-40892.s.

You can also make all Dynatrax track shapes use a profile by default by adding Dynatrax-* to the IncludeShapes parameter within one of the profiles. For example IncludedShapes ( "US3r_*, Dynatrax-*" ).

If you want some of the Dynatrax shapes to use a different profile than the default one, you can still rename those Dynatrax shapes with the USTracks prefixes like discussed above.

Further documentation:

More details on how to use these track profiles is available in the Open Rails documentation.

More information about the technical aspects of STF track profiles in Open Rails is available in this document.

Track Variants

USTracks package Variants to do Variants done
US1 US1, US1b, US1h, US1he
US2 US2, US2b, US2h, US2he
US3 US3, US3b, US3h, US3he, US3r, US3rb, US3rh, US3rhe

If anything is missing, feel free to suggest more by creating an issue.

Known issues

  • There is no good way to place objects at an interval along the generated track with STF profiles. For example the following is missing from super-elevated track:
    • Connectors between the rails in the US3r variants.
  • Dynatrax generated track sections are not super-elevated properly unless you add additional TrackSection and TrackShape entries to tsection.dat. How to do this is discussed in the Usage section.

Create an issue or pull request if you find more.

License

These track profiles were configured by Peter Grønbæk Andersen based on Norbert Rieger's original work on USTracks.

The profiles are licensed under CC BY-NC-SA 4.0.

Acknowledgements

In memory of Norbert Rieger.

All credit goes to Norbert as he is the author of the original USTracks shapes.

About

Track profiles to enable super-elevation with Norbert Rieger's USTracks in Open Rails.

Topics

Resources

License

Stars

Watchers

Forks

Languages