@ -19,10 +19,18 @@ This package has only been tested on a Windows system.
Using the [Anaconda distribution](https://www.anaconda.com/products/individual) of Python is recommended for easiest installation of the toolbox requirements.
Using the [Anaconda distribution](https://www.anaconda.com/products/individual) of Python is recommended for easiest installation of the toolbox requirements.
### Installation
### Installation
1. Clone this repo onto your PC: `git clone http://git.wrl.unsw.edu.au:3000/jonoc/coastsnap.git`
1. Install Git (if you don't already have it) for windows from the following link https://git-scm.com/download/win
2. Change your working directory into the repo: `cd CoastsnapAuto`
2. Clone this repo onto your PC: `git clone http://git.wrl.unsw.edu.au:3000/jonoc/coastsnap.git`
3. Create a new conda environment called "coastsnap" with the required dependencies. This is the same environment as for the Leaman CoastSnap Toolbox, so you may already have it. If you're not sure, run: `conda info --envs` and look for "coastsnap". Otherwise, create the environment by runnning:
3. Change your working directory into the repo: `cd CoastsnapAuto`
`conda env create -f environment.yml`
4. Update or create a new conda environment called "coastsnap" with the required dependencies. This is (almost) the same environment as for the Leaman CoastSnap Toolbox, so you may already have it. If you're not sure, run: `conda info --envs` and look for "coastsnap". If you already have the environment, run: `conda env update --name coastsnap --file environment.yml` to update it. Otherwise, create the environment by runnning:
`conda env create -f environment.yml`.
5. Check if you can activate the conda environment with `activate coastsnap`. If not, you may need to update your environment `Path` variable to include paths to the Anaconda install, like the following:
If `activate coastsnap` is still not working, you will have to edit each of the .bat files and substitute the first line `call activate coastsnap` with the direct path to the `activate.bat` file, such as "C:\Users\z5079346\Applications\Anaconda\Scripts\activate.bat". Substitute the third line `call deactivate` with the path to `deactivate.bat`
### Demo (optional)
### Demo (optional)
The following is a demo to make sure all of the code is working and for the user to get a sense of the intended workflow. It'll take approx. 10 mins (assuming everything works). The code will run on a demo CoastSnap directory (`CoastSnap_DEMO`) with 3 sites.
The following is a demo to make sure all of the code is working and for the user to get a sense of the intended workflow. It'll take approx. 10 mins (assuming everything works). The code will run on a demo CoastSnap directory (`CoastSnap_DEMO`) with 3 sites.
@ -30,14 +38,15 @@ The following is a demo to make sure all of the code is working and for the user
1. Open up `coastsnap_sites.csv`. Change the path name in cell E2, to the
1. Open up `coastsnap_sites.csv`. Change the path name in cell E2, to the
path of the CoastsnapAuto/CoastSnap_DEMO directory.
path of the CoastsnapAuto/CoastSnap_DEMO directory.
2. Open the CoastsnapAuto/coastsnap directory
2. Open the CoastsnapAuto/coastsnap directory
3. Run `batch_spotteron_download.bat` [30s]
3. Run `1_batch_spotteron_download.bat` [30s]
- This downloads 5 images each for 3 sites and stores them in CoastSnap_DEMO/Images/Site_Name/Processed)
- This downloads 5 images each for 3 sites and stores them in CoastSnap_DEMO/Images/Site_Name/Processed)
4. Run `batch_photoshop_registration.bat` [2 mins]
4. Run `2_batch_photoshop_registration.bat` [2 mins]
- Note: If this doesn't work. Make sure
- This registers the 15 images in photoshop and stores them in CoastSnap_DEMO/Images/Site_Name/Photoshop
- This registers the 15 images in photoshop and stores them in CoastSnap_DEMO/Images/Site_Name/Photoshop
5. Run `batch_tag_registered.bat` [3 mins]
5. Run `3_batch_tag_registered.bat` [3 mins]
- This tags the photoshop registered images and stores them in CoastSnap_DEMO/Images/Site_Name/Registered. Note: Loading .mat tide data in Python takes a while.
- This tags the photoshop registered images and stores them in CoastSnap_DEMO/Images/Site_Name/Registered. Note: Loading .mat tide data in Python takes a while.
6. Delete any poorly registered/tagged images in CoastSnap_DEMO/Images/Site_Name/Registered
6. Delete any poorly registered/tagged images in CoastSnap_DEMO/Images/Site_Name/Registered
7. Run `generate_images_snapshot.bat`
7. Run `4_generate_images_snapshot.bat`
- This generates a snapshot of the CoastSnap images directory at `images_snapshot.csv`
- This generates a snapshot of the CoastSnap images directory at `images_snapshot.csv`