# Catchment Area Hydrological Modeling in Google Colab

This repository is designed to work seamlessly with Google Colab for predicting hydrological outcomes in Catchment Areas A and B using advanced neural network architectures, GRU and LSTM.

## Getting Started

1. Upload the `CatchmentA` and `CatchmentB` folders to your Google Drive.
2. Open Google Colab and mount your Google Drive to access the files within Colab notebooks.
3. Set your working directory in Colab to the folder where you uploaded the model files.

## Directory Structure

- `/content/drive/MyDrive/CatchmentA/`
  - `GRU/`
    - `ARC/`
      - `Full/`
      - `TxTnRnStf/`
      - `RnStF/`
    - `NASAP/`
      - `Full/`
      - `TxTnRnStf/`
      - `RnStF/`
    - `CHIRPS/`
      - `TxTnRnStf/`
      - `RnStF/
  - `LSTM/`
    - [Same structure as GRU]

- `/content/drive/MyDrive/CatchmentB/`
  - [Same structure as CatchmentA]

Replace `/content/drive/MyDrive/` with the path to the folder where you have uploaded the data if it's different.

## Data Sources

- `ARC`: Agricultural Researh Council
- `NASAP`: National Aeronautics and Space Administration Prediction of Worldwide Energy Resources 
- `CHIRPS`: Climate Hazards Group InfraRed Precipitation with Station data

## Variable Combinations

- `Full`: Maximum temperature (Tx), Minimum temperature (Tn), Rainfall (Rn), Humidity (Hmd) and Streamflow (Stf).
- `TxTnRnStf`: Maximum temperature (Tx), Minimum temperature (Tn), Rainfall (Rn), and Streamflow (Stf).
- `RnStF`: Rainfall (Rn) and Streamflow (Stf) only.

## Execution

To run the models:
1. Navigate to the corresponding directory for your catchment area and desired model in Google Colab.
2. Open the modeling script in Colab.
3. Follow the instructions in the script's header to execute the model.

Scripts are set up to reference the data from the same directory. Ensure the paths in the scripts correctly point to the data files in your Google Drive.

## Collaboration and Updates

- When modifying scripts or data, record the changes in a version log within the script or in a separate `CHANGELOG.md` file in the respective directory.
- If you encounter issues or have updates, comment directly in the Google Colab notebook with your suggestions or corrections and notify the team.

For any assistance or to report issues, please reach out to the author at ceschutte34@gmail.com.