eqcctpro 0.4.1__tar.gz → 0.4.3__tar.gz

{eqcctpro-0.4.1 → eqcctpro-0.4.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.2
 Name: eqcctpro
-Version: 0.4.1
+Version: 0.4.3
 Description-Content-Type: text/markdown
 Requires-Dist: numpy==1.26.4
 Requires-Dist: pandas==2.2.3
@@ -39,27 +39,56 @@ EQCCTPro is a high-performace seismic event detection and processing framework t
 - Efficient handling of large-scale seismic data
 
 ## Installation
-To install the necessary dependencies, create a conda environment using:
+To install `EQCCTPro`, there are two installation approaches: 
+1. Install **EQCCTPro** out the box with no sample waveform data to test the application with (experts)
+2. Install **EQCCTPro** with the sample waveform data as provided from the Github folder (first-time users)
 
+It is **highly** recommended you pull the `EQCCTPro` folder to gain access to the sample waveform data and code to help you get acquainted with **EQCCTPro** and its capabilites.
+
+However, if you wish to install **only the EQCCTPro Python package and use it out of the box** (method 1), run:
 ```sh
-[skevofilaxc] conda env create -f environment.yml
-[skevofilaxc] conda activate eqcctpro
+**`pip install eqcctpro`**
+```
+**You must have at least Python verison 3.10.14 for the application to run**. 
+
+You can install Python 3.10.14 using either traditional methods or do the following commands: 
+```sh
+[skevofilaxc] conda create --name yourenvironemntname python=3.10.14 -y
+[skevofilaxc] conda activate yourenvironemntname 
+[skevofilaxc] python3 --version
+Python 3.10.14 (it should return)
+[skevofilaxc] pip install eqcctpro
+```
+You will have access to **EQCCTPro** and its capabilities, however, it is **highly** recommended you pull the `EQCCTPro` folder to gain access to the sample waveform data to help you get acquainted with **EQCCTPro's** functionality. 
+You can pull the `EQCCTPro` folder by running the following commands: 
+
+```sh
+[skevofilaxc] mkdir my_work_directory
+[skevofilaxc] cd my_work_directory
+[skevofilaxc] git clone --depth 1 --filter=tree:0 https://github.com/ut-beg-texnet/eqcct.git --sparse
+[skevofilaxc] cd eqcct
+[skevofilaxc] git sparse-checkout set eqcctpro
 ```
 
-You can get the `environment.yml` file from the `eqcct` repository. You can download the entire eqcct repository or download only the `eqcctpro` repository using the following command: 
+If you wish to install **EQCCTPro** with the sample waveform data as **originally intended for first-time users**, and or are having trouble installing Python 3.10.14, there has been a precreated conda environment under the `EQCCTPro` folder that will install the necessary packages
+and dependencies needed for **EQCCTPro** to run (method 2). 
 
+You can pull the `EQCCTPro` folder, create the precreated conda environment, and activate it as originally intended for first-time users using the following commands: 
 ```sh
 [skevofilaxc] mkdir my_work_directory
 [skevofilaxc] cd my_work_directory
 [skevofilaxc] git clone --depth 1 --filter=tree:0 https://github.com/ut-beg-texnet/eqcct.git --sparse
 [skevofilaxc] cd eqcct
 [skevofilaxc] git sparse-checkout set eqcctpro
+[skevofilaxc] conda env create -f environment.yml
+[skevofilaxc] conda activate eqcctpro
 ```
-After creating and activating the conda environment, install the **eqcctpro Python package** using the following command: 
+
+After creating and activating the conda environment, install the **EQCCTPro Python package** using the following command: 
 ```sh
 [skevofilaxc] pip install eqcctpro
 ```
-More information on the package can be found at our PyPi project link [eqcctpro](https://pypi.org/project/eqcctpro/).
+The pip package will install the remaining packages needed for **EQCCTPro** to work. More information on the eqcctpro pip package can be found at our PyPi project link here [(EQCCTPro)](https://pypi.org/project/eqcctpro/).
 
 ## Creating a Test Workspace Environment
 It's highly suggested to create a workspace environment to first understand how eqcctpro works. 
@@ -299,7 +328,7 @@ Both **OptimalCPUConfigurationFinder** and **OptimalGPUConfigurationFinder** eac
 
 1. **`find_best_overall_usecase`**
   - Returns the best overall usecase configuration 
-    - Uses middel 50% of CPUs for moderate, balanced CPU usage, with the maximum amount of stations processed with the minimum runtime 
+    - Uses middle 50% of CPUs for moderate, balanced CPU usage, with the maximum amount of stations processed with the minimum runtime 
 2. **`find_optimal_for`**
   - Return the paralleliztion configurations (EX. concurrent predictions, intra/inter thread counts, vram, etc.) for a given number of CPU(s)/GPU(s) and stations
     - Enables users to quickly identify which input parameters should be used for the given amount of resources and workload they have for the minimum runtime possible on their computer
@@ -336,5 +365,5 @@ The `environment.yml` file specifies the dependencies required to run EQCCTPro.
 EQCCTPro is provided under an open-source license. See LICENSE for details.
 
 ## Contact
-For inquiries or issues, please contact constantinos.skevofilax@austin.utexas.edu.
+For inquiries or issues, please contact constantinos.skevofilax@austin.utexas.edu or victor.salles@beg.utexas.edu.
 

{eqcctpro-0.4.1 → eqcctpro-0.4.3}/README.md

@@ -10,27 +10,56 @@ EQCCTPro is a high-performace seismic event detection and processing framework t
 - Efficient handling of large-scale seismic data
 
 ## Installation
-To install the necessary dependencies, create a conda environment using:
+To install `EQCCTPro`, there are two installation approaches: 
+1. Install **EQCCTPro** out the box with no sample waveform data to test the application with (experts)
+2. Install **EQCCTPro** with the sample waveform data as provided from the Github folder (first-time users)
 
+It is **highly** recommended you pull the `EQCCTPro` folder to gain access to the sample waveform data and code to help you get acquainted with **EQCCTPro** and its capabilites.
+
+However, if you wish to install **only the EQCCTPro Python package and use it out of the box** (method 1), run:
 ```sh
-[skevofilaxc] conda env create -f environment.yml
-[skevofilaxc] conda activate eqcctpro
+**`pip install eqcctpro`**
+```
+**You must have at least Python verison 3.10.14 for the application to run**. 
+
+You can install Python 3.10.14 using either traditional methods or do the following commands: 
+```sh
+[skevofilaxc] conda create --name yourenvironemntname python=3.10.14 -y
+[skevofilaxc] conda activate yourenvironemntname 
+[skevofilaxc] python3 --version
+Python 3.10.14 (it should return)
+[skevofilaxc] pip install eqcctpro
+```
+You will have access to **EQCCTPro** and its capabilities, however, it is **highly** recommended you pull the `EQCCTPro` folder to gain access to the sample waveform data to help you get acquainted with **EQCCTPro's** functionality. 
+You can pull the `EQCCTPro` folder by running the following commands: 
+
+```sh
+[skevofilaxc] mkdir my_work_directory
+[skevofilaxc] cd my_work_directory
+[skevofilaxc] git clone --depth 1 --filter=tree:0 https://github.com/ut-beg-texnet/eqcct.git --sparse
+[skevofilaxc] cd eqcct
+[skevofilaxc] git sparse-checkout set eqcctpro
 ```
 
-You can get the `environment.yml` file from the `eqcct` repository. You can download the entire eqcct repository or download only the `eqcctpro` repository using the following command: 
+If you wish to install **EQCCTPro** with the sample waveform data as **originally intended for first-time users**, and or are having trouble installing Python 3.10.14, there has been a precreated conda environment under the `EQCCTPro` folder that will install the necessary packages
+and dependencies needed for **EQCCTPro** to run (method 2). 
 
+You can pull the `EQCCTPro` folder, create the precreated conda environment, and activate it as originally intended for first-time users using the following commands: 
 ```sh
 [skevofilaxc] mkdir my_work_directory
 [skevofilaxc] cd my_work_directory
 [skevofilaxc] git clone --depth 1 --filter=tree:0 https://github.com/ut-beg-texnet/eqcct.git --sparse
 [skevofilaxc] cd eqcct
 [skevofilaxc] git sparse-checkout set eqcctpro
+[skevofilaxc] conda env create -f environment.yml
+[skevofilaxc] conda activate eqcctpro
 ```
-After creating and activating the conda environment, install the **eqcctpro Python package** using the following command: 
+
+After creating and activating the conda environment, install the **EQCCTPro Python package** using the following command: 
 ```sh
 [skevofilaxc] pip install eqcctpro
 ```
-More information on the package can be found at our PyPi project link [eqcctpro](https://pypi.org/project/eqcctpro/).
+The pip package will install the remaining packages needed for **EQCCTPro** to work. More information on the eqcctpro pip package can be found at our PyPi project link here [(EQCCTPro)](https://pypi.org/project/eqcctpro/).
 
 ## Creating a Test Workspace Environment
 It's highly suggested to create a workspace environment to first understand how eqcctpro works. 
@@ -270,7 +299,7 @@ Both **OptimalCPUConfigurationFinder** and **OptimalGPUConfigurationFinder** eac
 
 1. **`find_best_overall_usecase`**
   - Returns the best overall usecase configuration 
-    - Uses middel 50% of CPUs for moderate, balanced CPU usage, with the maximum amount of stations processed with the minimum runtime 
+    - Uses middle 50% of CPUs for moderate, balanced CPU usage, with the maximum amount of stations processed with the minimum runtime 
 2. **`find_optimal_for`**
   - Return the paralleliztion configurations (EX. concurrent predictions, intra/inter thread counts, vram, etc.) for a given number of CPU(s)/GPU(s) and stations
     - Enables users to quickly identify which input parameters should be used for the given amount of resources and workload they have for the minimum runtime possible on their computer
@@ -307,5 +336,5 @@ The `environment.yml` file specifies the dependencies required to run EQCCTPro.
 EQCCTPro is provided under an open-source license. See LICENSE for details.
 
 ## Contact
-For inquiries or issues, please contact constantinos.skevofilax@austin.utexas.edu.
+For inquiries or issues, please contact constantinos.skevofilax@austin.utexas.edu or victor.salles@beg.utexas.edu.
 

{eqcctpro-0.4.1 → eqcctpro-0.4.3}/eqcctpro.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.2
 Name: eqcctpro
-Version: 0.4.1
+Version: 0.4.3
 Description-Content-Type: text/markdown
 Requires-Dist: numpy==1.26.4
 Requires-Dist: pandas==2.2.3
@@ -39,27 +39,56 @@ EQCCTPro is a high-performace seismic event detection and processing framework t
 - Efficient handling of large-scale seismic data
 
 ## Installation
-To install the necessary dependencies, create a conda environment using:
+To install `EQCCTPro`, there are two installation approaches: 
+1. Install **EQCCTPro** out the box with no sample waveform data to test the application with (experts)
+2. Install **EQCCTPro** with the sample waveform data as provided from the Github folder (first-time users)
 
+It is **highly** recommended you pull the `EQCCTPro` folder to gain access to the sample waveform data and code to help you get acquainted with **EQCCTPro** and its capabilites.
+
+However, if you wish to install **only the EQCCTPro Python package and use it out of the box** (method 1), run:
 ```sh
-[skevofilaxc] conda env create -f environment.yml
-[skevofilaxc] conda activate eqcctpro
+**`pip install eqcctpro`**
+```
+**You must have at least Python verison 3.10.14 for the application to run**. 
+
+You can install Python 3.10.14 using either traditional methods or do the following commands: 
+```sh
+[skevofilaxc] conda create --name yourenvironemntname python=3.10.14 -y
+[skevofilaxc] conda activate yourenvironemntname 
+[skevofilaxc] python3 --version
+Python 3.10.14 (it should return)
+[skevofilaxc] pip install eqcctpro
+```
+You will have access to **EQCCTPro** and its capabilities, however, it is **highly** recommended you pull the `EQCCTPro` folder to gain access to the sample waveform data to help you get acquainted with **EQCCTPro's** functionality. 
+You can pull the `EQCCTPro` folder by running the following commands: 
+
+```sh
+[skevofilaxc] mkdir my_work_directory
+[skevofilaxc] cd my_work_directory
+[skevofilaxc] git clone --depth 1 --filter=tree:0 https://github.com/ut-beg-texnet/eqcct.git --sparse
+[skevofilaxc] cd eqcct
+[skevofilaxc] git sparse-checkout set eqcctpro
 ```
 
-You can get the `environment.yml` file from the `eqcct` repository. You can download the entire eqcct repository or download only the `eqcctpro` repository using the following command: 
+If you wish to install **EQCCTPro** with the sample waveform data as **originally intended for first-time users**, and or are having trouble installing Python 3.10.14, there has been a precreated conda environment under the `EQCCTPro` folder that will install the necessary packages
+and dependencies needed for **EQCCTPro** to run (method 2). 
 
+You can pull the `EQCCTPro` folder, create the precreated conda environment, and activate it as originally intended for first-time users using the following commands: 
 ```sh
 [skevofilaxc] mkdir my_work_directory
 [skevofilaxc] cd my_work_directory
 [skevofilaxc] git clone --depth 1 --filter=tree:0 https://github.com/ut-beg-texnet/eqcct.git --sparse
 [skevofilaxc] cd eqcct
 [skevofilaxc] git sparse-checkout set eqcctpro
+[skevofilaxc] conda env create -f environment.yml
+[skevofilaxc] conda activate eqcctpro
 ```
-After creating and activating the conda environment, install the **eqcctpro Python package** using the following command: 
+
+After creating and activating the conda environment, install the **EQCCTPro Python package** using the following command: 
 ```sh
 [skevofilaxc] pip install eqcctpro
 ```
-More information on the package can be found at our PyPi project link [eqcctpro](https://pypi.org/project/eqcctpro/).
+The pip package will install the remaining packages needed for **EQCCTPro** to work. More information on the eqcctpro pip package can be found at our PyPi project link here [(EQCCTPro)](https://pypi.org/project/eqcctpro/).
 
 ## Creating a Test Workspace Environment
 It's highly suggested to create a workspace environment to first understand how eqcctpro works. 
@@ -299,7 +328,7 @@ Both **OptimalCPUConfigurationFinder** and **OptimalGPUConfigurationFinder** eac
 
 1. **`find_best_overall_usecase`**
   - Returns the best overall usecase configuration 
-    - Uses middel 50% of CPUs for moderate, balanced CPU usage, with the maximum amount of stations processed with the minimum runtime 
+    - Uses middle 50% of CPUs for moderate, balanced CPU usage, with the maximum amount of stations processed with the minimum runtime 
 2. **`find_optimal_for`**
   - Return the paralleliztion configurations (EX. concurrent predictions, intra/inter thread counts, vram, etc.) for a given number of CPU(s)/GPU(s) and stations
     - Enables users to quickly identify which input parameters should be used for the given amount of resources and workload they have for the minimum runtime possible on their computer
@@ -336,5 +365,5 @@ The `environment.yml` file specifies the dependencies required to run EQCCTPro.
 EQCCTPro is provided under an open-source license. See LICENSE for details.
 
 ## Contact
-For inquiries or issues, please contact constantinos.skevofilax@austin.utexas.edu.
+For inquiries or issues, please contact constantinos.skevofilax@austin.utexas.edu or victor.salles@beg.utexas.edu.
 

{eqcctpro-0.4.1 → eqcctpro-0.4.3}/setup.py

@@ -1,5 +1,22 @@
 from setuptools import setup, find_packages
 import os
+import sys
+
+# Ensure the user has the latest Python version
+REQUIRED_PYTHON = (3, 10, 14)  # Change this to the minimum version you require
+
+if sys.version_info < REQUIRED_PYTHON:
+    sys.stderr.write(f"""
+==========================
+Unsupported Python version
+==========================
+This package requires Python {REQUIRED_PYTHON[0]}.{REQUIRED_PYTHON[1]}.{REQUIRED_PYTHON[2]} or higher.
+You are using Python {sys.version_info.major}.{sys.version_info.minor}.
+Please upgrade Python and try again.
+
+Visit https://www.python.org/downloads/ to install the latest version.
+""")
+    sys.exit(1)
 
 # Ensure TensorFlow and CUDA are initialized before running
 os.environ["TF_CPP_MIN_LOG_LEVEL"] = "3"
@@ -13,7 +30,7 @@ with open("README.md", "r") as f:
 
 setup(
     name="eqcctpro",
-    version="0.4.1",
+    version="0.4.3",
     packages=find_packages(),
     install_requires=[
         "numpy==1.26.4",