eqcctpro 0.4.7__tar.gz → 0.4.9__tar.gz

{eqcctpro-0.4.7/eqcctpro.egg-info → eqcctpro-0.4.9}/PKG-INFO

@@ -1,11 +1,11 @@
 Metadata-Version: 2.2
 Name: eqcctpro
-Version: 0.4.7
+Version: 0.4.9
 Summary: EQCCTPro: A powerful seismic event detection toolkit
 Author-email: Constantinos Skevofilax <constantinos.skevofilax@austin.utexas.edu>, Victor Salles <victor.salles@beg.utexas.edu>
 Project-URL: Homepage, https://pypi.org/project/eqcctpro/
-Project-URL: Repository, https://github.com/ut-beg-texnet/eqcctpro
-Project-URL: Issues, https://github.com/ut-beg-texnet/eqcctpro/issues
+Project-URL: Repository, https://github.com/ut-beg-texnet/eqcct/tree/main/eqcctpro
+Project-URL: Issues, https://github.com/ut-beg-texnet/eqcct/tree/main/eqcctpro/issues
 Project-URL: Documentation, https://github.com/ut-beg-texnet/eqcct/blob/main/eqcctpro/README.md
 Requires-Python: >=3.10.14
 Description-Content-Type: text/markdown
@@ -55,14 +55,8 @@ It is **highly recommended** that first-time users pull the `EQCCTPro` folder, w
 ## **Method 1: Install EQCCTPro (No Sample Data)**
 This method installs only the EQCCTPro package **without** the sample waveform data.
 
-### **Step 1: Install EQCCTPro**
-Run the following command:
-```sh
-pip install eqcctpro
-```
-
-### **Step 2: Ensure Python 3.10.14 is Installed**
-EQCCTPro **requires Python 3.10.14 or higher**. If you don’t have it installed, you can create a conda environment with the correct Python version:
+### **Step 1: Create a Clean Conda Environment for the Install**
+EQCCTPro **requires Python 3.10.14 or higher as well as minimum Tensorflow packages**. If you have a clean working environment, you can simply run `pip install eqcctpro`. However, if you have a nonclean environment, its highly recommended to create a new conda environment so that you can install the necessary packages safely with no issues. You can create a new conda environment with the correct Python version by using the following commands:
 
 ```sh
 [skevofilaxc] conda create --name yourenvironemntname python=3.10.14 -y
@@ -74,13 +68,14 @@ Expected output:
 Python 3.10.14
 ```
 
-Now, reinstall EQCCTPro:
+After activating your new conda environment, run the following command:  
 ```sh
 [skevofilaxc] pip install eqcctpro
 ```
+You will have access to EQCCTPro and its functionality. However you will not have immediate access to the provided sample waveform data to use for testing. Youcan pull the waveform data either by downloading the .zip file from the repository or by following step 3. 
 
 ### **Step 3 (Optional): Pull the EQCCTPro Folder**
-Although not required, **it is highly recommended** to pull the `EQCCTPro` folder to gain access to sample waveform data.
+Although not required, **it is highly recommended** to pull the `EQCCTPro` folder to gain access to sample waveform data for testing.
 
 ```sh
 [skevofilaxc] mkdir my_work_directory
@@ -350,6 +345,17 @@ The following input parameters need to be configurated for **EvaluateSystem** to
   - Allows for specific allocation and limitation of CPUs for a given EQCCTPro process 
     - "I want this program to run only on these specific cores." 
   - Must be at least 1 CPU if using GPUs (Ray needs CPUs to manage the Raylets (concurrent tasks), however the processing of the waveform is done on the GPU)
+- **`starting_amount_of_stations (int)`: default = 1** 
+  - For evaluating your system, you have the option to set a starting amount of stations you want to use in the test
+  - By default, the test will start using 1 station but now is configurable 
+- **`station_list_step_size (int)`: default = 1** 
+  - You can set a step size for the station list that is generated 
+  - For example if the stepsize is set to 10 and you start with 50 stations with a max of 100, then your list would be: [50, 60, 70, 80, 80, 100]
+  - Using 1 will use the default step size of 1-10, then step size of 5 up to station2use
+- **`min_cpu_amount (int)`: default = 1**
+  - Is the minimum amount of CPUs you want to start your trials with 
+  - By default, trials will start iterating with 1 CPU up to the maximum allocated 
+  - Can now set a value as the starting point, such as 15 CPUs up to the maximum of for instance 25
 - **`set_vram_mb (float)`**
   - Value of the maximum amount of VRAM EQCCTPro can use 
   - Must be a real value that is based on your hardware's physical memory space, if it exceeds the space the code will break due to OutOfMemoryError 
@@ -357,6 +363,7 @@ The following input parameters need to be configurated for **EvaluateSystem** to
   - List of GPU IDs on your computer you want to use if `mode = 'gpu'`
   - Non-existing GPU IDs will cause the code to exit 
 
+
 ---
 ### **Finding Optimal CPU/GPU Configurations**
 After running **EvalutateSystem**, you can use either the **OptimalCPUConfigurationFinder** or the **OptimalGPUConfigurationFinder** determine the best CPU or GPU configurations (respectively) for your specific usecase:

eqcctpro-0.4.7/PKG-INFO → eqcctpro-0.4.9/README.md

@@ -1,36 +1,3 @@
-Metadata-Version: 2.2
-Name: eqcctpro
-Version: 0.4.7
-Summary: EQCCTPro: A powerful seismic event detection toolkit
-Author-email: Constantinos Skevofilax <constantinos.skevofilax@austin.utexas.edu>, Victor Salles <victor.salles@beg.utexas.edu>
-Project-URL: Homepage, https://pypi.org/project/eqcctpro/
-Project-URL: Repository, https://github.com/ut-beg-texnet/eqcctpro
-Project-URL: Issues, https://github.com/ut-beg-texnet/eqcctpro/issues
-Project-URL: Documentation, https://github.com/ut-beg-texnet/eqcct/blob/main/eqcctpro/README.md
-Requires-Python: >=3.10.14
-Description-Content-Type: text/markdown
-Requires-Dist: numpy==1.26.4
-Requires-Dist: pandas==2.2.3
-Requires-Dist: matplotlib==3.10.0
-Requires-Dist: obspy==1.4.1
-Requires-Dist: progress==1.6
-Requires-Dist: psutil==6.1.1
-Requires-Dist: ray==2.42.1
-Requires-Dist: schedule==1.2.2
-Requires-Dist: sdnotify==0.3.2
-Requires-Dist: tensorflow<2.19,>=2.15
-Requires-Dist: tensorflow-estimator<2.19,>=2.15
-Requires-Dist: tensorflow-io-gcs-filesystem==0.37.1
-Requires-Dist: tensorboard==2.15.2
-Requires-Dist: tensorboard-data-server==0.7.2
-Requires-Dist: silence-tensorflow==1.2.3
-Requires-Dist: scipy==1.15.1
-Requires-Dist: protobuf==4.25.6
-Requires-Dist: grpcio==1.70.0
-Requires-Dist: absl-py==2.1.0
-Requires-Dist: h5py==3.12.1
-Requires-Dist: pynvml==12.0.0
-
 # **EQCCTPro: powerful seismic event detection toolkit**
 
 EQCCTPro is a high-performace seismic event detection and processing framework that leverages DL-pickers, like EQCCT, to process seismic data efficiently. It enables users to fully leverage the computational ability of their computing resources for maximum performance for simultaneous seismic waveform processing, achieving real-time performance by identifying and utilizing the optimal computational configurations for their hardware. More information about the development, capabilities, and real-world applications about EQCCTPro can be read about in our research publication here.  
@@ -55,14 +22,8 @@ It is **highly recommended** that first-time users pull the `EQCCTPro` folder, w
 ## **Method 1: Install EQCCTPro (No Sample Data)**
 This method installs only the EQCCTPro package **without** the sample waveform data.
 
-### **Step 1: Install EQCCTPro**
-Run the following command:
-```sh
-pip install eqcctpro
-```
-
-### **Step 2: Ensure Python 3.10.14 is Installed**
-EQCCTPro **requires Python 3.10.14 or higher**. If you don’t have it installed, you can create a conda environment with the correct Python version:
+### **Step 1: Create a Clean Conda Environment for the Install**
+EQCCTPro **requires Python 3.10.14 or higher as well as minimum Tensorflow packages**. If you have a clean working environment, you can simply run `pip install eqcctpro`. However, if you have a nonclean environment, its highly recommended to create a new conda environment so that you can install the necessary packages safely with no issues. You can create a new conda environment with the correct Python version by using the following commands:
 
 ```sh
 [skevofilaxc] conda create --name yourenvironemntname python=3.10.14 -y
@@ -74,13 +35,14 @@ Expected output:
 Python 3.10.14
 ```
 
-Now, reinstall EQCCTPro:
+After activating your new conda environment, run the following command:  
 ```sh
 [skevofilaxc] pip install eqcctpro
 ```
+You will have access to EQCCTPro and its functionality. However you will not have immediate access to the provided sample waveform data to use for testing. Youcan pull the waveform data either by downloading the .zip file from the repository or by following step 3. 
 
 ### **Step 3 (Optional): Pull the EQCCTPro Folder**
-Although not required, **it is highly recommended** to pull the `EQCCTPro` folder to gain access to sample waveform data.
+Although not required, **it is highly recommended** to pull the `EQCCTPro` folder to gain access to sample waveform data for testing.
 
 ```sh
 [skevofilaxc] mkdir my_work_directory
@@ -350,6 +312,17 @@ The following input parameters need to be configurated for **EvaluateSystem** to
   - Allows for specific allocation and limitation of CPUs for a given EQCCTPro process 
     - "I want this program to run only on these specific cores." 
   - Must be at least 1 CPU if using GPUs (Ray needs CPUs to manage the Raylets (concurrent tasks), however the processing of the waveform is done on the GPU)
+- **`starting_amount_of_stations (int)`: default = 1** 
+  - For evaluating your system, you have the option to set a starting amount of stations you want to use in the test
+  - By default, the test will start using 1 station but now is configurable 
+- **`station_list_step_size (int)`: default = 1** 
+  - You can set a step size for the station list that is generated 
+  - For example if the stepsize is set to 10 and you start with 50 stations with a max of 100, then your list would be: [50, 60, 70, 80, 80, 100]
+  - Using 1 will use the default step size of 1-10, then step size of 5 up to station2use
+- **`min_cpu_amount (int)`: default = 1**
+  - Is the minimum amount of CPUs you want to start your trials with 
+  - By default, trials will start iterating with 1 CPU up to the maximum allocated 
+  - Can now set a value as the starting point, such as 15 CPUs up to the maximum of for instance 25
 - **`set_vram_mb (float)`**
   - Value of the maximum amount of VRAM EQCCTPro can use 
   - Must be a real value that is based on your hardware's physical memory space, if it exceeds the space the code will break due to OutOfMemoryError 
@@ -357,6 +330,7 @@ The following input parameters need to be configurated for **EvaluateSystem** to
   - List of GPU IDs on your computer you want to use if `mode = 'gpu'`
   - Non-existing GPU IDs will cause the code to exit 
 
+
 ---
 ### **Finding Optimal CPU/GPU Configurations**
 After running **EvalutateSystem**, you can use either the **OptimalCPUConfigurationFinder** or the **OptimalGPUConfigurationFinder** determine the best CPU or GPU configurations (respectively) for your specific usecase:

eqcctpro-0.4.7/README.md → eqcctpro-0.4.9/eqcctpro.egg-info/PKG-INFO

@@ -1,3 +1,36 @@
+Metadata-Version: 2.2
+Name: eqcctpro
+Version: 0.4.9
+Summary: EQCCTPro: A powerful seismic event detection toolkit
+Author-email: Constantinos Skevofilax <constantinos.skevofilax@austin.utexas.edu>, Victor Salles <victor.salles@beg.utexas.edu>
+Project-URL: Homepage, https://pypi.org/project/eqcctpro/
+Project-URL: Repository, https://github.com/ut-beg-texnet/eqcct/tree/main/eqcctpro
+Project-URL: Issues, https://github.com/ut-beg-texnet/eqcct/tree/main/eqcctpro/issues
+Project-URL: Documentation, https://github.com/ut-beg-texnet/eqcct/blob/main/eqcctpro/README.md
+Requires-Python: >=3.10.14
+Description-Content-Type: text/markdown
+Requires-Dist: numpy==1.26.4
+Requires-Dist: pandas==2.2.3
+Requires-Dist: matplotlib==3.10.0
+Requires-Dist: obspy==1.4.1
+Requires-Dist: progress==1.6
+Requires-Dist: psutil==6.1.1
+Requires-Dist: ray==2.42.1
+Requires-Dist: schedule==1.2.2
+Requires-Dist: sdnotify==0.3.2
+Requires-Dist: tensorflow<2.19,>=2.15
+Requires-Dist: tensorflow-estimator<2.19,>=2.15
+Requires-Dist: tensorflow-io-gcs-filesystem==0.37.1
+Requires-Dist: tensorboard==2.15.2
+Requires-Dist: tensorboard-data-server==0.7.2
+Requires-Dist: silence-tensorflow==1.2.3
+Requires-Dist: scipy==1.15.1
+Requires-Dist: protobuf==4.25.6
+Requires-Dist: grpcio==1.70.0
+Requires-Dist: absl-py==2.1.0
+Requires-Dist: h5py==3.12.1
+Requires-Dist: pynvml==12.0.0
+
 # **EQCCTPro: powerful seismic event detection toolkit**
 
 EQCCTPro is a high-performace seismic event detection and processing framework that leverages DL-pickers, like EQCCT, to process seismic data efficiently. It enables users to fully leverage the computational ability of their computing resources for maximum performance for simultaneous seismic waveform processing, achieving real-time performance by identifying and utilizing the optimal computational configurations for their hardware. More information about the development, capabilities, and real-world applications about EQCCTPro can be read about in our research publication here.  
@@ -22,14 +55,8 @@ It is **highly recommended** that first-time users pull the `EQCCTPro` folder, w
 ## **Method 1: Install EQCCTPro (No Sample Data)**
 This method installs only the EQCCTPro package **without** the sample waveform data.
 
-### **Step 1: Install EQCCTPro**
-Run the following command:
-```sh
-pip install eqcctpro
-```
-
-### **Step 2: Ensure Python 3.10.14 is Installed**
-EQCCTPro **requires Python 3.10.14 or higher**. If you don’t have it installed, you can create a conda environment with the correct Python version:
+### **Step 1: Create a Clean Conda Environment for the Install**
+EQCCTPro **requires Python 3.10.14 or higher as well as minimum Tensorflow packages**. If you have a clean working environment, you can simply run `pip install eqcctpro`. However, if you have a nonclean environment, its highly recommended to create a new conda environment so that you can install the necessary packages safely with no issues. You can create a new conda environment with the correct Python version by using the following commands:
 
 ```sh
 [skevofilaxc] conda create --name yourenvironemntname python=3.10.14 -y
@@ -41,13 +68,14 @@ Expected output:
 Python 3.10.14
 ```
 
-Now, reinstall EQCCTPro:
+After activating your new conda environment, run the following command:  
 ```sh
 [skevofilaxc] pip install eqcctpro
 ```
+You will have access to EQCCTPro and its functionality. However you will not have immediate access to the provided sample waveform data to use for testing. Youcan pull the waveform data either by downloading the .zip file from the repository or by following step 3. 
 
 ### **Step 3 (Optional): Pull the EQCCTPro Folder**
-Although not required, **it is highly recommended** to pull the `EQCCTPro` folder to gain access to sample waveform data.
+Although not required, **it is highly recommended** to pull the `EQCCTPro` folder to gain access to sample waveform data for testing.
 
 ```sh
 [skevofilaxc] mkdir my_work_directory
@@ -317,6 +345,17 @@ The following input parameters need to be configurated for **EvaluateSystem** to
   - Allows for specific allocation and limitation of CPUs for a given EQCCTPro process 
     - "I want this program to run only on these specific cores." 
   - Must be at least 1 CPU if using GPUs (Ray needs CPUs to manage the Raylets (concurrent tasks), however the processing of the waveform is done on the GPU)
+- **`starting_amount_of_stations (int)`: default = 1** 
+  - For evaluating your system, you have the option to set a starting amount of stations you want to use in the test
+  - By default, the test will start using 1 station but now is configurable 
+- **`station_list_step_size (int)`: default = 1** 
+  - You can set a step size for the station list that is generated 
+  - For example if the stepsize is set to 10 and you start with 50 stations with a max of 100, then your list would be: [50, 60, 70, 80, 80, 100]
+  - Using 1 will use the default step size of 1-10, then step size of 5 up to station2use
+- **`min_cpu_amount (int)`: default = 1**
+  - Is the minimum amount of CPUs you want to start your trials with 
+  - By default, trials will start iterating with 1 CPU up to the maximum allocated 
+  - Can now set a value as the starting point, such as 15 CPUs up to the maximum of for instance 25
 - **`set_vram_mb (float)`**
   - Value of the maximum amount of VRAM EQCCTPro can use 
   - Must be a real value that is based on your hardware's physical memory space, if it exceeds the space the code will break due to OutOfMemoryError 
@@ -324,6 +363,7 @@ The following input parameters need to be configurated for **EvaluateSystem** to
   - List of GPU IDs on your computer you want to use if `mode = 'gpu'`
   - Non-existing GPU IDs will cause the code to exit 
 
+
 ---
 ### **Finding Optimal CPU/GPU Configurations**
 After running **EvalutateSystem**, you can use either the **OptimalCPUConfigurationFinder** or the **OptimalGPUConfigurationFinder** determine the best CPU or GPU configurations (respectively) for your specific usecase:

{eqcctpro-0.4.7 → eqcctpro-0.4.9}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "eqcctpro"
-version = "0.4.7"
+version = "0.4.9"
 description = "EQCCTPro: A powerful seismic event detection toolkit"
 readme = "README.md"
 requires-python = ">=3.10.14"
@@ -39,8 +39,8 @@ dependencies = [
 
 [project.urls]
 Homepage = "https://pypi.org/project/eqcctpro/"
-Repository = "https://github.com/ut-beg-texnet/eqcctpro"
-Issues = "https://github.com/ut-beg-texnet/eqcctpro/issues"
+Repository = "https://github.com/ut-beg-texnet/eqcct/tree/main/eqcctpro"
+Issues = "https://github.com/ut-beg-texnet/eqcct/tree/main/eqcctpro/issues"
 Documentation = "https://github.com/ut-beg-texnet/eqcct/blob/main/eqcctpro/README.md"
 
 [tool.setuptools.packages.find]