By Published On: November 24th, 2023Categories: Civil Site Design, Development

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.

Related Posts

  • In conjunction with our partners Civil Survey Solutions, we are excited to announce the following upcoming training courses for our products Civil Site Design and Stringer Topo.  The courses are delivered by our experts and the training team at Civil Survey Solutions. As an Authorised Autodesk Training Center and Application Developer, you can trust that […]

  • Civil Survey Applications recently hosted the ‘Civil Site Design: Council User Training Day’ in Parramatta, NSW. This complimentary technical training workshop was centred on civil engineering and design for local government users, with a focus on practical application of Civil Site Design features. The agenda was designed to deliver direct value to the attendees through […]

  • Since releasing Civil Site Design in the USA in 2007, we have experienced constant growth. A technical distributor, Logis LLC, was appointed in 2015, followed by the establishment of Civil Survey Applications LLC in 2019. Located in Florida, the team of 5 including three civil engineers, is committed to customising the software for the US […]