VS Code Tips

From Tuflow
Jump to navigation Jump to search


Visual Studio Code (commonly referred to as VS Code) is a free source code editor developed by Microsoft. It can be downloaded here. It supports a variety of file types and can be used to work with TUFLOW control files. Thousands of free plugins exist for VS Code and some of them are useful when working with TUFLOW models.

TUFLOW VS Code Plugin

The TUFLOW plugin provides syntax highlighting support. Thanks to Daniel Copelin for creating the TUFLOW plugin. One feature of VS Code is that it includes an explorer window from a root folder, so it is easy to navigate the files within a project.

Install TUFLOW Plugin

The TUFLOW Plugin can be installed like any other VS Code plugins. In the VS Code application:

  1. Select 'Extensions' from the toolbar on the right-hand side.
  2. Search for 'TUFLOW'.
  3. Select install.

File Navigation

In VS Code, it is possible to create and edit TUFLOW models and their control files.

  • Select File > Open Folder and navigate to the model folder. This will open the model folder into the 'Explorer' panel.
  • Now, from the Explorer panel, it is possible to navigate through the model folders and edit control files.
  • Using the Open File plugin, it is possible to easily navigate between files.

Running TUFLOW

To run TUFLOW through VS Code, the Batch Runner extension is required. Once installed, TUFLOW can be run by either:

  • Right clicking the batch file in the explorer panel and selecting 'Run Batch File', or

  • Open the batch file into the editor, and press the 'Run' button.

This will open a terminal and the TUFLOW simulation will run.

Other Useful Plugins

In addition to the TUFLOW plugin, some useful plugins for working with TUFLOW include:

Open File

  • Open File by Frank Stuetzer or similar is a free plugin available for download here.
  • Right-click on a filename and select 'Open file under cursor'. If the file is found by VS Code, then the selected file will open in a new tab.
  • To open multiple files, hold down Alt while selecting the filenames, then right click and select 'Open file under cursor'. If the files are found by VS Code, then the selected files will each open in a new tab.

Path Autocomplete

  • Path Autocomplete by Mihai Vilcu is a free plugin available for download here.
  • Adds auto-complete when it determines a filename is being written. For this feature to work, set the 'triggerOutsideStrings' to true (as described in the plugin details).
  1. From the file menu, choose File\Preferences\Settings. Then select 'path-autocomplete' under 'Extensions'.
  2. Toggle on the 'Trigger Outside Strings' in the settings on the right.
  • An example of its functionality is shown below.

Geo Data Viewer

  • Geo Data Viewer by Random Fractals inc is a free plugin available for download here.
  • Has the ability to view a map of GIS layers right inside of VS Code. This is helpful for double checking that the layer looks correct without loading it into a GIS application.
  • An example of its functionality is shown below.

Note: This extension only supports certain file formats, including Shapefile. It does not support GeoPackage or GeoTiff files.