Advanced Scripting for Precise Cross Section Editing
ScriptX is our new scripting tool for Civil Site Design, designed to work with the existing Variations feature. It gives designers the power to write their own scripts for editing cross sections, which can be as simple or as complex as needed. With ScriptX, whether you are constructing a conditional retaining wall or making minor sectional adjustments, designers can start with the basics and progressively build up their scripting skills, customising edits as they grow more comfortable with the tool’s capabilities.
Figure 1: An example of a ScriptX-implemented gabion wall, illustrating the use of conditional logic to automate design adjustments.
Logical Operations for Customised Editing
ScriptX enhances cross section editing by allowing designers to embed conditional logic directly into their designs. A designer can, for example, set a cross section to widen to an alignment only if it meets certain conditions. Similarly, sections can be programmed to insert or remove themselves automatically, depending on the logic criteria established in the script.
Integration into Design Data Form
Scripts created with ScriptX are added to the Variations list through the Design Data Form. By specifying a chainage range, the script is configured to methodically apply its logic to each corresponding section within the range. These ScriptX scripts function in tandem with other Variations, ensuring they are executed in sequence as the software progresses through the Variations list.
Figure 2: The Design Data Form showcasing the Variations list, with the option to add a new ScriptX script for custom cross-section modifications.
ScriptX Basics: Getting Started
After creating a new ScriptX script entry, begin by right-clicking within the script editor to access the Menu system. Here, you will find a helpful link to the ScriptX help system — your go-to programmer’s reference that details the script’s syntax and provides easy-to-follow examples to kick-start your scripting process.
The Menu System is organised into categories: ‘Control Structures’, ‘Properties’, and ‘Commands’. ‘Control Structures’ help you weave in logic, like ‘if’ statements, into your scripts. ‘Properties’ give you access to design details such as current code elevations or offsets. ‘Commands’ are there for you to make edits to the current cross section, including inserting, deleting, or modifying codes.
Figure 3: The ScriptX editor interface displaying the right-click menu system, offering quick access to help resources and a variety of scripting commands for efficient script construction.
Below is a straightforward example of ScriptX in action:
This basic script defines a variable called ‘newSlope’ with a value of 7, which is then assigned to the slope property of the LFPI code.
// Override slope behind kerb
newSlope == 7
SetCodeSlope LFPI|newSlope
Figure 4: The resulting cross-section after applying the ScriptX code, which sets the ‘LFPI’ code’s slope to the new value of 7, demonstrating the immediate impact of script adjustments.
ScriptX Collaboration: Share, Download, and Customise with Ease
Sharing and collaboration are easy with ScriptX. To save a script, select ‘Save Script’ from the ‘File’ section in the Menu System. To use a script someone else has created, choose ‘Insert Script’ from the same menu.
Download a Driveway Layback Example Script:
Ready to see ScriptX in action? Click below to download a sample script for a driveway layback. Once you have inserted the script into your project, you can adjust the variables to specify the layback dimensions and modify the necessary codes.
Below is a link to download the Driveway Layback script:
Download: https://www.downloads.civilsurveysolutions.com//TrainingFiles/DrivewayLayback.scX
Figure 5: Visual representation of a driveway layback created using ScriptX, illustrating how the scripting language can handle more complex cross section edits.
In Conclusion: Unleashing Full Potential with ScriptX
The introduction of ScriptX marks a new era of versatility in editing cross sections within Civil Site Design. To fully harness the capabilities of ScriptX, delve into our Programmer’s Reference, which offers a wealth of information to enhance your scripting skills.
ScriptX Programmer’s Reference: https://www.downloads.civilsurveysolutions.com/CSD/Documents/ScriptX-ProgrammersReference.pdf
We are excited to see the sophisticated solutions you will craft with ScriptX at your fingertips.
In this webinar we demonstrate the best practice for using Model Builder and unpack all the functionality to operate it successfully, using a road and parking bay design.
In Civil Site Design V24.10, the Design Data Form has undergone some ergonomic improvements and seen the addition of a new Design Variation – Offset by Polyline.
In Civil Site Design V24.10, the Model Builder Edit/Trim by Selection & Group forms received an update which can have a significant impact on selecting sections for trimming models.
The DRAINS exchange for Civil Site Design has been established for over 10 years and has provided users with a solution of drafting in the CAD environment, analysing in DRAINS and generating design long sections with the HGL in Civil Site Design. This popular functionality has been a staple for drainage engineers looking to speed up the process of designing and drafting between the applications.
