If you are using one of the supported, commercial Fortran compilers, then it is possible to utilize the integrated debugger application included with the respective compiler. The following sections describe how to preset relevant project settings, as well as step-by-step instructions on how to link EMTDC with your debugger.
If you are using the free GFortran compiler supplied with PSCAD, there are debugging tools available. See http://sources.redhat.com/insight/index.php.
There are a few project settings that must be preset before attempting to proceed – all of which are set in the Project Settings dialog. See Editing Project Settings for details.
In the Runtime section of the dialog, enable the Start simulation manually to allow use of integrated debugger option. Enabling this option allows EMTDC to be started manually.
Next, navigate to the Fortran section of the dialog and enable the Enable addition of runtime debugging information option in the Runtime Debugging area.
Ensure that any required user source files are referenced in the Resources Branch as well. If you fail to do this, your source files will not be included when the project is compiled, and you will not be able to debug your code.
The following procedure outlines how to set-up an integrated debugging session for your case project. Note that the following steps are described using the Intel Fortran 10 compiler.
Ensure that the project settings described above in Project Options to Preset are enabled. Run the simulation. A pop-up message should appear as follows:
Click on the details button and partially copy the string therein, as shown below. Or simply write it down on a scrap of paper. This string will be needed later on, when setting up the debugging environment.
Select the No button to continue with debugging.
Open Microsoft Visual Studio and select File | Open | Project/Solution.
Change the Objects of Type drop list to Executable Files (*.exe).
Navigate to the PSCAD Temporary Folder associated with your project file, select the executable file (*.exe) for your project and then click the Open button. For example, if your project is entitled 'MyProject.pscx', then you would select 'MyProject.exe' from the temporary folder as shown below:
While still in Microsoft Visual Studio, select Project | Properties... to bring up the Properties dialog.
In the Arguments field, enter the string that was copied or noted in Step 2:
-v5 -config MyProject_1.config
Save and close the Properties dialog after entering the argument.
While still in Microsoft Visual Studio, open the appropriate Fortran source file (*.f) by selecting File | Open | File.... Navigate to and then open a Fortran file generated by PSCAD (ex. Main.f).
Insert a breakpoint at the point where your subroutine is called in the source code and press the Start Debugging button. Manually step in to your subroutine.
NOTE: It is important to note that a breakpoint should not be placed directly within your Fortran source file. This is because PSCAD makes a copy of your source file when the executable is built, and so your original Fortran source is not accessed!
Once debugging is complete and the code is clean, make sure that all debugging options outlined in the Project Options to Preset section are disabled. Failure to do so may affect simulation speed.