Release Notes for QSWAT3 and QSWAT3_64 version 1.1
QSWAT3 and QSWAT3_64 are 32 bit and 64 bit ports of QSWAT to QGIS 3. Existing users of QSWAT and ArcSWAT can continue to use their current installation of the SWAT Editor and the SWAT executable with QSWAT3 and QSWAT3_64.
You choose between QSWAT3 and QSWAT3_64 based primarily not on what machine you have but on whether you have a 32 bit version of Microsoft Office, or a 64 bit, or don't have Microsoft Office at all.
If you have a 32 bit machine or you have a 32 bit version of Microsoft Office on a 64 bit machine, you need a 32 bit version of QGIS 3 (currently you should choose 3.16) and QSWAT3. You should also download and install Microsoft Access Database Engine Redistributable 2016, and choose the 32 bit version (called accessdatabaseengine.exe).
If you have a 64 bit machine with no Microsoft Office, or with a 64 bit version of Microsoft Office, you you need a 64 bit version of QGIS 3 (currently you should choose 3.16) and QSWAT3_64. You should also download and install Microsoft Access Database Engine Redistributable 2016, and choose the 64 bit version (called accessdatabaseengine_X64.exe).
If you make a mistake and there is a mismatch between your version of Microsoft Office and the database engine you choose, you will get a warning that you need to uninstall Microsoft Office. Don't do that! Back out without uninstalling Office and check these release notes again.
Warning: QSWAT3 and QSWAT3_64 are functionally equivalent to QSWAT. The change to QGIS3 is being made because QGIS2 is no longer supported. While we have tried to ensure that QSWAT3 is free from bugs, it is new code. If you are in the middle of a project you are strongly advised to complete it before upgrading. You can install QGIS3 and QSWAT3 at the same time as QGIS2 and QSWAT2. Existing QSWAT projects will load into QGIS3 and QSWAT3, with just a warning about the old project file, which you can ignore unless you want to go back to QGIS2.
- Microsoft Windows (any version, as far as we are aware)
- Text editor and a tool to unzip archived files
- SWAT Editor - requirements include:
- Microsoft Windows
- Microsoft .Net Framework 3.5
- Adobe Acrobat Reader version 7 or higher
- Install QGIS3 by going to the QGIS download page and selecting under Long term release repository (most stable) the QGIS Standalone Installer Version 3.16 (32 bit or 64 bit: see Release Notes above for which to choose). This gives you an executable file which you run to install QGIS3. Use the default folder C:\Program Files\QGIS 3.16 (or C:\Program Files (x86)\QGIS 3.16) as the installation folder. Note that it is essential that you select QGIS3 rather than the earlier QGIS2, because they use different versions of the Python language, and it is also essential that you select a 32 bit or 64 bit version according to the Release Notes, and the corresponding QSWAT3 or QSWAT3_64. We recommend that you select the long term release version of QGIS (currently 3.16) because that is the one we test QSWAT3 against.
- Install SWAT Editor 2012 in its standard place C:\SWAT\SWATEditor.
- Refer to Appendix I of the QSWAT Manual for help updating a database.
- Refer to the SWATEditor_Documentation.pdf in C:\SWAT\SWATEditor\SWATEditorHelp for help getting started.
- Install QSWAT3. This adds some files to the SWATEditor: a project database and a reference database in Databases, SWATGraph in the SWATGraph folder, and also stores the TauDEM executables in a new directory C:\SWAT\SWATEditor\TauDEM5Bin. You are given a choice to install QSWAT3 just for yourself or everyone. It is recommended to choose the first, and this causes the QGIS plugin QSWAT3 to be put into the user's home folder as
AppData\Roaming\QGIS\QGIS3\profiles\default\python\plugins\QSWAT3. If you instead choose to install for everyone, administrator privileges are required.