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.
Revolutionise your Civil Site Design with Project Assist: Automating medians and splitter islands effortlessly. This AI-powered tool streamlines island integration by detecting alignments, automatically trimming road strings, and enhancing precision with minimal manual input.
Check out the performance improvements we have introduced for all Civil 3D Corridor creators out there!
-
Check out the performance improvements we've introduced into Civil Site Design V24.20 when you're working in the Vertical Grading Editor window.
We've enhanced the superelevation tools to make it easier for you to quickly and easily assess output of rules-based superelevation, and to make it simple for you to use this tool to vary pavement crossfalls and widths.
