User Guide ^^^^^^^^^^ The Folder Data will contain all data that has been collected during the network tests (currently only ping test supported). All files that are stored in Data will not be deleted. Instead all new data will be appended to the existing existing file. Please make sure to not push your custom data collection to the GitRepo but include it in the .gitignore. Getting Started --------------- 1. Clone the git repository. 2. Make sure Python 3.7 is installed in the system. 3. Install the required Python packages. This can be done using `sudo pip3 install -r requirements.txt`. 4. Run the test. This can be done using `sudo python3 run_test.py` along with the arguments. The list of valid arguments can be found by running `sudo python3 run_test.py --help`. 5. After running the test for desired amount of time, send keyboard interrupt by pressing `Ctrl + C` twice. The data should get stored in the `Data` folder while the graph should get stored in `webpage/figures` folder. 6. Open `webpage/index.html` in the browser to view the interactive graphs. Run Network Analysis -------------------- 1. Make sure to complete all steps from the section Getting Started 2. Run network test with weekly email reporting by using a gmail account: `sudo python3 network_cli.py` 3. To get further information about possible options use `sudo python3 network_cli.py --help` Getting started with the GUI ---------------------------- Prerequisites +++++++++++++ You'll need PyQt5 and other libraries from requirements.txt Running +++++++ Navigate to the project's root folder, and run `python3 network_qt5.py` with root priviledges.