GeoEPIC Toolkit Installation Guide
This guide provides instructions for installing the GeoEPIC Toolkit.
1. Prerequisites
Before you begin, ensure you have Conda installed. You can find installation guides here: Conda Installation.
2. Automatic Installation (Recommended)
This method automates the installation process using a script.
-
Download the setup script:
- Download the
epic_setup.bat
script to your local machine.
- Download the
-
Run the setup script:
- Open your command prompt or PowerShell.
- Navigate to the directory where you saved the
epic_setup.bat
script. - Execute the script using the following command:
- What to expect: The script will automatically create a Conda environment, install the GeoEPIC Toolkit, and configure necessary dependencies. You should see the progress of these actions in the command prompt.
3. Manual Installation (Alternative)
This method allows for more control over the installation process. Choose either this method or the automatic installation method (section 2), not both.
-
Create a virtual environment in Conda:
- Open your command prompt or terminal.
- Run the following command to create a new Conda environment named
epic_env
with Python 3.11: - What to expect: Conda will create the environment and install Python 3.11.
-
Activate the environment:
- After the environment is created, activate it using:
- What to expect: Your command prompt or terminal will show
(epic_env)
at the beginning of the line, indicating the environment is active.
-
Install the GeoEPIC Toolkit:
-
Option 1: Install Directly from GitHub (Recommended for general users):
- Run the following command:
- What to expect:
pip
will download and install the latest version of the GeoEPIC Toolkit from the GitHub repository.
-
Option 2: Install Locally (for developers):
- Clone the repository:
- Navigate to the cloned directory:
- Install the toolkit:
- What to expect: The repository will be downloaded, and the toolkit will be installed from your local files, allowing you to make and test changes.
-
4. Verify Installation
- Activate the environment (if not already active):
- Initialize GeoEPIC:
- What to expect: If the installation was successful, the
geo_epic init
command will run without errors. If you see an error, recheck your installation steps.
- What to expect: If the installation was successful, the
5. Additional Notes
-
Updating GeoEPIC Toolkit:
- To update to the latest version, use:
-
Uninstalling GeoEPIC Toolkit:
- To uninstall, use:
-
Troubleshooting:
- If you encounter issues, refer to the GeoEPIC Toolkit documentation or seek help from the community.
6. Example Usage
After successful installation, you can begin using the GeoEPIC Toolkit.
-
Initialize a new GeoEPIC project:
- What to expect: A new directory named
my_project
will be created with the necessary project files.
- What to expect: A new directory named
-
Navigate to your project directory:
-
Run a sample analysis:
- What to expect: The
geo_epic analyze
command will run an analysis on thesample_data.csv
file within your project directory. Ensure that you have a file called sample_data.csv in your my_project folder, or replace sample_data.csv with the correct filename.
- What to expect: The