Material Plot

This program was designed to create a map of specified locations from an input data sheet.

Description

The material_plot program creates a new map, adds each location from the input data sheet to the map, and saves a KMZ file of the populated map. The program uses Google Maps and therefore requires the user to have/login to a Google account.

Improvements

This program could be enhanced for smoother operation and additional features:

Headless Mode: A more conservative version of the program to run in the background without visuals.

• Use Mozilla Firefox web browser and script the login process.

• Start the login process in non-headless mode and switch to headless mode after the user logs in.

Location Sorting: Implement sorting of location coordinates in ascending/descending order to optimize map navigation.

Getting Started

Dependencies

• Selenium
• Tkinter
• PyInstaller
• pytest

Installing

• Download this repository
• pip install pyinstaller
• Navigate to project root directory
• pyinstaller --onefile src\main.py
• Executable created in dist folder

Executing program

• Format input .csv file
• Move input .csv file to input directory
• Navigate to dist folder
• Run main.exe
• Log in to Google account
• Press 'OK' to proceed to plotting/exporting
• Download map

Help

• If there is an error following the login process, please press 'Retry' on the dialogue box.
• The program is known to idle on close due to unknown WebDriver behavior.
• If there is a version error, make sure that the Chrome web browser is up to date.

Authors

Noah Hensley | Bitbucket | Handshake

Version History

• 1.1
  • Added support for custom .csv file names
  • Various bug fixes and optimizations
  • See commit change
• 1.0
  • Initial Release

Acknowledgments

• README-Template