Agroclimatological Tools Knowledge Base
English French Spanish
English French Spanish

FEWS Tools Installation

New versions of FEWS tools plugin are released periodically as bugs are discovered and repaired, or when performance improvements are implemented. This installation guide explains how to install the plugin for the first time and how to update an existing installation to the latest release.

If you’re new to FEWS Tools, follow the instructions for first time installation. If you already have the plugin, skip to the update section.

A video tutorial on installing the plugin is also available at the bottom of the page.

System requirements

  • Microsoft Windows Operating System (10 or later)

  • QGIS 3.34.3 +

Download FEWS tools plugin (all users)

Download the latest version of the plugin.

Install the FEWS tools plugin

First time installation (new users)

  1. Open QGIS.

  2. Go to the Plugins menu.

  3. Select Manage and Install Plugins.

  4. Select Install from ZIP.

  5. Browse and select the fews_tools.zip file that you just downloaded.

  6. Click on Install Plugin and follow the instructions.

QGIS plugins menu showing the Manage and install plugins option and resulting screen.
Choose the zip file from your computer to install the plugin.
  1. Click Yes to accept all warnings and prompts that follow.

Example of a warning that may appear. Click yes to continue with the installation.
Confirm the creation of the workspace fews_tools_WS.
  1. In QGIS, navigate to the Plugins menu and ensure there's a checkmark next to FEWS Tools to activate the plugin.

Plugins menu showing FEWS Tools selected.
Checkmarks indicate which plugins have been turned on.
  1. In some cases, it is necessary to restart QGIS. Once the plugin is installed, the FEWS Tools pull-down menu appears on the QGIS main bar.

FEWS Tools menu.png
Once the plugin is installed the new pulldown menu FEWS Tools appears on the main toolbar in QGIS.
  1. Click on the FEWS Tools menu.

  2. Select GeoCLIM/GeoCLIM Tools or GeoWRSI to activate the tool bars. Once the GeoCLIM tools are activated, a menu bar will appear with several selections as shown below.

QGIS interface with the GeoCLIM toolbar.
Select the GeoCLIM Tools to see the available functions.

At this point the tool is ready to use. Continue on to FEWS Tools Settings.  

How to move the workspace

By default the FEWS Tools plugin is installed in C:\Users\[user]\Documents\fews_tools_WS. You may want to move the default folder to another drive to get more disk space or for other reasons. 

To move the workspace:

  1. Click Workplace Setting (yellow folder icon as seen in the GeoCLIM toolbar).

  2. Browse to select a folder for the new workspace location.

  3. Click Ok and click Yes to confirm.

You don’t need to pre-create the fews_tools_WS folder. Simply select the destination drive (or parent folder) and FEWS Tools will automatically create fews_tools_WS there and set it as the workspace.

Update (current users)

If you have an older version of the FEWS Tools plugin, you can install a new version while preserving your datasets, regions, and preferences.

Copy fews_tools.sqlite

All the datasets and region definitions that you have created are saved on the database file fews_tools.sqlite, in the fews_tools directory in C:\Users\[name]\AppData\Roaming\QGIS\QGIS3\profiles\default\python\plugins\fews_tools (see image below).

Before installing a new version of the plugin, make a copy of the fews_tools.sqlite file in a separate directory.

FEWS Tools sqlite.png
Backup the fews_tools.sqlite file to keep all your settings.

NOTE: Make sure to frequently back up the database file fews_tools.sqlite which contains all the changes you have made to customize the plugin, including the datasets, regions, path to new workspace, etc.

Install a new version

To install the new version, follow the steps below:

  1. Uninstall the plugin

    1. From the main QGIS toolbar, navigate to Plugins > Manage and Install Plugins.

    2. Select FEWS Tools.

    3. Select Uninstall Plugin.

  2. Install the new version of the plugin as described in the above instructions for new users.

  3. Replace the default fewstools.sqlite file in C:\Users\[name]\AppData\Roaming\QGIS\QGIS3\profiles\default\python\plugins\fews_tools with the one saved from the previous version.

  4. Restart QGIS.

Installed plugins menu showing FEWS Tools selected.
Uninstall all previous versions of the plugin before installing a new one.

NOTE: If you previously moved the workspace from the default to a new directory before installing the new version, the path is corrected by replacing the fews_tools.sqlite file.

Troubleshooting

Problem: The FEWS Tools menu doesn’t appear.

If the FEWS Tools option doesn’t appear in the main QGIS toolbar, try the following:

  • Under Plugins > Manage and Install Plugins, ensure FEWS Tools is checked.

  • Restart QGIS. If the issue persists, uninstall and reinstall from the ZIP file.

Problem: Permission error during install.

If you receive a permission error during installation, try the following:

  • Close QGIS and reopen it “As Administrator.”

  • Ask IT for write permissions to your QGIS profile.

Problem: Plugin installed but my datasets/regions are missing.

If your datasets/regions are missing after installation, try the following:

  • Verify you copied your backup fewstools.sqlite to the correct path (see instructions above).

Video tutorial: Installation of the FEWS Tools plugin

(12:13, includes closed captions and transcript)