pycoustic 0.1.2__tar.gz → 0.1.3__tar.gz

pycoustic-0.1.3/PKG-INFO

@@ -0,0 +1,103 @@
+Metadata-Version: 2.3
+Name: pycoustic
+Version: 0.1.3
+Summary: 
+Author: thumpercastle
+Author-email: tony.ryb@gmail.com
+Requires-Python: >=3.10,<4.0
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Requires-Dist: numpy (==2.2.6)
+Requires-Dist: openpyxl (==3.1.5)
+Requires-Dist: pandas (==2.2.3)
+Requires-Dist: requests (>=2.32.4,<3.0.0)
+Description-Content-Type: text/markdown
+
+# pycoustic - Toolkit for Analysing Noise Survey Data
+## Overview
+pycoustic is a Python-based toolkit designed to assist acoustic consultants and engineers in analyzing noise survey data. The library provides various tools and utilities for processing, interpreting, and visualizing noise measurements.
+
+## Requirements
+This toolkit was written in Python 3.12. See the pyrpoject.toml for the latest dependencies.
+
+## Features
+- Import and process noise survey data from .csv files
+- Analyse and recompute sound levels and statistical meausres (Leq, Lmax, L90 etc.)
+- Handle large datasets from multiple measurement positions efficiently
+- Visualise noise data through customisable plots (WIP)
+- Generate reports with summary statistics (WIP)
+
+## Installation
+The library is not currently available through pip or Anaconda (we're working on it). You can pull the code from git, or simply download the files on this GitHub page.
+
+## Usage
+**Before you start**
+Make sure your input data is in the correct format. See the file UA1_py.csv for reference. Namely:
+- Your data must be in .csv format.
+- Timestamps should ideally be in the format *dd-mm-yyyy hh:mm*, other formats may work, but their performance is not tried and tested.
+- Column headers should be in the Tuple-like format as per the example csv files attached. The measurement index should be first, and the frequency band or weighting should be second. e.g. the LAeq column should have the header *"Leq A"*, the L90 column at 125 Hz should have the header *"L90 125"*, and so on.
+- Make sure you past your data and columns into a fresh csv tab. If you end up having to chop the data and delete columns or rows, repaste it into a fresh tab when it is ready to be presented to the toolkit. Failure to do so can result in a ValueError. See **Troubleshooting** below.
+- If you do use this toolkit, please attribute it appropriately, and carry out your own checks to ensure you are satisfied with the outputs. See **Terms of Use** below.
+### Basic Workflow
+1. **Import the library**\
+   Import the library into your script or active console.
+   ```
+   from pycoustic import*
+   ```
+2. **Load Data**\
+   A single measurement position can be loaded into a Log object.
+   ```
+   log1 = Log(path="path/to/data_for_pos1.csv")
+   log2 = Log(path="path/to/data_for_pos2.csv")
+   ```
+3. **Combine Data**\
+   The data from multiple measurement positions can be combined together within a Survey object.
+   First we need to create a Survey object, and then add each Log one at a time.
+   ```
+   surv = Survey()
+   surv.add_log(data=log1, name="Position 1")
+   surv.add_log(data=log2, name="Position 2")
+   ```
+4. **Analyse the Survey Data**
+   The following are methods of the Survey() object representing the typical use cases for acoustic consultants in the UK.
+   ### Survey.resi_summary()
+   This method provides a summary of the measurement data for residential projects, with a focus on typical assessment procedures in the UK.
+   It presents A-weighted Leqs for each day and night period (and evenings, if enabled), as well as the nth-highest LAmax during each night-time period.
+   Optional arguments are:\
+   **leq_cols** *List of tuples* *(default [("Leq", "A")]* Which column(s) you want to present as Leqs - this can be any Leq or statistical column.\
+   **max_cols** *List of tuples* *(default [("Leq", "A")]* Which column(s) you want to present as an nth-highest value - this can be any column.\
+   **lmax_n** *Int* *(default 10)* The nth-highest value to present.\
+   **lmax_t** *Str* *(default "2min")* The time period T over which Lmaxes are presented. This must be equal to or longer than the period of the raw data.
+   
+   ### Survey.modal_l90()
+   Compute the modal L90 for daytime, evening (if enabled) and night-time periods. By default, this is set to T=60min for (23:00 to 07:00) periods, and T=15min for night-time (23:00 to 07:00) periods, as per BS 4142:2014.
+   
+   ### Survey.lmax_spectra()
+   Compute the Lmax Event spectra for the nth-highest Lmax during each night-time period.\
+   **Note** the date presented alongside the Lmax event is actually the starting date of the night-time period. i.e. an Lmax event with a stamp of 20/12/2024 at 01:22 would actually have occurred on 21/12/2024 at 01:22. These stamps can also sometimes be out by a minute (known bug).
+   
+   ### Survey.typical_leq_spectra()
+   Compute the Leq spectra for daytime, evening (if enabled) and night-time periods. This will present the overall Leqs across the survey, not the Leq for each day.
+   
+
+### Other methods
+### Known issues
+- Lmax night-time timestamps can sometimes by out by a minute.
+- [RESOLVED 07/02/2025] modal_L90 keyword 'cols' does not work due to headers not being properly allocated.
+## Troubleshooting
+### ValueError: NaTType does not support time
+This error occurs when trying to create a Log() object with a csv file. It occurs because the source csv file contains empty cells which were previously allocated (filled). It usually happens when you have entered data into some row(s) or column(s) and then deleted it, leaving previously-full cells which are now empty.\
+**Solution:** Create a new tab in your source csv file, and paste in your headers and data as you wish it to be presented to the toolkit, avoiding having to delete any columns and rows. Delete the old tab. If you do have to delete any data in the new tab, you will need to repeat the process to ensure this error is not thrown up again.
+
+## Terms of use
+The pycoustic toolkit was built by Tony Trup of [Timbral](https://www.timbral.co.uk).
+Neither I nor Timbral Ltd. accept any liability for the outputs of this toolkit. You use it at your own risk, and you should carry out your own checks and balances to ensure you are satistfied that the output is accurate.
+This is an open source project, and I welcome suggestions for changes, improvements or new features. You can also write your own methods or functions and share them with me, either by getting in touch offline, or by creating a new branch from this Git repository.
+You may use this toolkit subject to the licence conditions below. For clarity, you may use this toolkit or adaptations of it in your day-to-day engineering work, but incorporating it into a commercial software product or service is not permitted.
+This project is being shared under a [Creative Commons CC BY-NC-SA 4.0 Licence](https://creativecommons.org/licenses/by-nc-sa/4.0/).
+Attribution — You must give appropriate credit , provide a link to the license, and indicate if changes were made. You may do so in any reasonable manner, but not in any way that suggests the licensor endorses you or your use.
+NonCommercial — You may not use the material for commercial purposes.
+ShareAlike — If you remix, transform, or build upon the material, you must distribute your contributions under the same license as the original.

pycoustic-0.1.3/README.md

@@ -0,0 +1,85 @@
+# pycoustic - Toolkit for Analysing Noise Survey Data
+## Overview
+pycoustic is a Python-based toolkit designed to assist acoustic consultants and engineers in analyzing noise survey data. The library provides various tools and utilities for processing, interpreting, and visualizing noise measurements.
+
+## Requirements
+This toolkit was written in Python 3.12. See the pyrpoject.toml for the latest dependencies.
+
+## Features
+- Import and process noise survey data from .csv files
+- Analyse and recompute sound levels and statistical meausres (Leq, Lmax, L90 etc.)
+- Handle large datasets from multiple measurement positions efficiently
+- Visualise noise data through customisable plots (WIP)
+- Generate reports with summary statistics (WIP)
+
+## Installation
+The library is not currently available through pip or Anaconda (we're working on it). You can pull the code from git, or simply download the files on this GitHub page.
+
+## Usage
+**Before you start**
+Make sure your input data is in the correct format. See the file UA1_py.csv for reference. Namely:
+- Your data must be in .csv format.
+- Timestamps should ideally be in the format *dd-mm-yyyy hh:mm*, other formats may work, but their performance is not tried and tested.
+- Column headers should be in the Tuple-like format as per the example csv files attached. The measurement index should be first, and the frequency band or weighting should be second. e.g. the LAeq column should have the header *"Leq A"*, the L90 column at 125 Hz should have the header *"L90 125"*, and so on.
+- Make sure you past your data and columns into a fresh csv tab. If you end up having to chop the data and delete columns or rows, repaste it into a fresh tab when it is ready to be presented to the toolkit. Failure to do so can result in a ValueError. See **Troubleshooting** below.
+- If you do use this toolkit, please attribute it appropriately, and carry out your own checks to ensure you are satisfied with the outputs. See **Terms of Use** below.
+### Basic Workflow
+1. **Import the library**\
+   Import the library into your script or active console.
+   ```
+   from pycoustic import*
+   ```
+2. **Load Data**\
+   A single measurement position can be loaded into a Log object.
+   ```
+   log1 = Log(path="path/to/data_for_pos1.csv")
+   log2 = Log(path="path/to/data_for_pos2.csv")
+   ```
+3. **Combine Data**\
+   The data from multiple measurement positions can be combined together within a Survey object.
+   First we need to create a Survey object, and then add each Log one at a time.
+   ```
+   surv = Survey()
+   surv.add_log(data=log1, name="Position 1")
+   surv.add_log(data=log2, name="Position 2")
+   ```
+4. **Analyse the Survey Data**
+   The following are methods of the Survey() object representing the typical use cases for acoustic consultants in the UK.
+   ### Survey.resi_summary()
+   This method provides a summary of the measurement data for residential projects, with a focus on typical assessment procedures in the UK.
+   It presents A-weighted Leqs for each day and night period (and evenings, if enabled), as well as the nth-highest LAmax during each night-time period.
+   Optional arguments are:\
+   **leq_cols** *List of tuples* *(default [("Leq", "A")]* Which column(s) you want to present as Leqs - this can be any Leq or statistical column.\
+   **max_cols** *List of tuples* *(default [("Leq", "A")]* Which column(s) you want to present as an nth-highest value - this can be any column.\
+   **lmax_n** *Int* *(default 10)* The nth-highest value to present.\
+   **lmax_t** *Str* *(default "2min")* The time period T over which Lmaxes are presented. This must be equal to or longer than the period of the raw data.
+   
+   ### Survey.modal_l90()
+   Compute the modal L90 for daytime, evening (if enabled) and night-time periods. By default, this is set to T=60min for (23:00 to 07:00) periods, and T=15min for night-time (23:00 to 07:00) periods, as per BS 4142:2014.
+   
+   ### Survey.lmax_spectra()
+   Compute the Lmax Event spectra for the nth-highest Lmax during each night-time period.\
+   **Note** the date presented alongside the Lmax event is actually the starting date of the night-time period. i.e. an Lmax event with a stamp of 20/12/2024 at 01:22 would actually have occurred on 21/12/2024 at 01:22. These stamps can also sometimes be out by a minute (known bug).
+   
+   ### Survey.typical_leq_spectra()
+   Compute the Leq spectra for daytime, evening (if enabled) and night-time periods. This will present the overall Leqs across the survey, not the Leq for each day.
+   
+
+### Other methods
+### Known issues
+- Lmax night-time timestamps can sometimes by out by a minute.
+- [RESOLVED 07/02/2025] modal_L90 keyword 'cols' does not work due to headers not being properly allocated.
+## Troubleshooting
+### ValueError: NaTType does not support time
+This error occurs when trying to create a Log() object with a csv file. It occurs because the source csv file contains empty cells which were previously allocated (filled). It usually happens when you have entered data into some row(s) or column(s) and then deleted it, leaving previously-full cells which are now empty.\
+**Solution:** Create a new tab in your source csv file, and paste in your headers and data as you wish it to be presented to the toolkit, avoiding having to delete any columns and rows. Delete the old tab. If you do have to delete any data in the new tab, you will need to repeat the process to ensure this error is not thrown up again.
+
+## Terms of use
+The pycoustic toolkit was built by Tony Trup of [Timbral](https://www.timbral.co.uk).
+Neither I nor Timbral Ltd. accept any liability for the outputs of this toolkit. You use it at your own risk, and you should carry out your own checks and balances to ensure you are satistfied that the output is accurate.
+This is an open source project, and I welcome suggestions for changes, improvements or new features. You can also write your own methods or functions and share them with me, either by getting in touch offline, or by creating a new branch from this Git repository.
+You may use this toolkit subject to the licence conditions below. For clarity, you may use this toolkit or adaptations of it in your day-to-day engineering work, but incorporating it into a commercial software product or service is not permitted.
+This project is being shared under a [Creative Commons CC BY-NC-SA 4.0 Licence](https://creativecommons.org/licenses/by-nc-sa/4.0/).
+Attribution — You must give appropriate credit , provide a link to the license, and indicate if changes were made. You may do so in any reasonable manner, but not in any way that suggests the licensor endorses you or your use.
+NonCommercial — You may not use the material for commercial purposes.
+ShareAlike — If you remix, transform, or build upon the material, you must distribute your contributions under the same license as the original.

pycoustic-0.1.3/pycoustic/__init__.py

@@ -0,0 +1,3 @@
+from .log import Log
+from .survey import Survey
+from .weather import WeatherHistory

{pycoustic-0.1.2 → pycoustic-0.1.3}/pycoustic/log.py

@@ -1,7 +1,7 @@
 import pandas as pd
 import numpy as np
 import datetime as dt
-import warnings
+
 
 
 class Log:

{pycoustic-0.1.2 → pycoustic-0.1.3}/pycoustic/survey.py

@@ -3,6 +3,11 @@ import numpy as np
 from .weather import WeatherHistory
 
 
+DECIMALS=0
+
+# pd.set_option('display.max_columns', None)
+# pd.set_option('display.max_rows', None)
+
 class Survey:
     """
     Survey Class is an overarching class which takes multiple Log objects and processes and summarises them together.
@@ -13,6 +18,7 @@ class Survey:
 
     def __init__(self):
         self._logs = {}
+        self._weather = WeatherHistory()
 
     def _insert_multiindex(self, df=None, super=None, name1="Position", name2="Date"):
         subs = df.index.to_list()   # List of subheaders (dates)
@@ -287,6 +293,13 @@ class Survey:
         ends = [self._logs[key].get_end() for key in self._logs.keys()]
         return min(starts), max(ends)
 
+    def weather(self, interval=6, api_key="", country="GB", postcode="WC1", tz="",):
+        start, end = self.get_start_end()
+        self._weather.reinit(start=start, end=end, interval=interval, api_key=api_key, country=country,
+                             postcode=postcode, tz=tz, units="metric")
+        self._weather.compute_weather_history()
+        return self._weather.get_weather_history()
+
     # def typical_leq_spectra(self, leq_cols=None):
     #     """
     #     DEPRECATED 2025/06/05. Replaced by .leq_spectra() **TT**

{pycoustic-0.1.2 → pycoustic-0.1.3}/pycoustic/tkgui.py

@@ -11,6 +11,7 @@ from tkinter import StringVar
 #from matplotlib.backends.backend_tkagg import FigureCanvasTkAgg
 
 #from src import log  # Assuming log is an instance of a class with the required methods
+test = 0
 
 class Application(tk.Tk):
     

{pycoustic-0.1.2 → pycoustic-0.1.3}/pycoustic/weather.py

@@ -2,6 +2,7 @@ import requests
 import pandas as pd
 import datetime as dt
 
+test=0
 
 appid = ""
 with open("tests/openweather_app_id.txt") as f:
@@ -27,9 +28,13 @@ def test_weather_obj(weather_test_dict):
 #TODO: Make this take the start and end times of a Survey object.
 #TODO: Implement post codes instead of coordinates
 class WeatherHistory:
-    def __init__(self, start=None, end=None, interval=6, api_key="", country="GB", postcode="WC1", tz="",
+    def __init__(self):
+        return
+
+    def reinit(self, start=None, end=None, interval=6, api_key="", country="GB", postcode="WC1", tz="",
                  units="metric"):
-        # self._history_df = pd.DataFrame()
+        if api_key==None:
+            raise ValueError("API key is missing")
         if type(start) == str:
             self._start = dt.datetime.strptime(start, "%Y-%m-%d %H:%M:%S")
         else:

{pycoustic-0.1.2 → pycoustic-0.1.3}/pyproject.toml

@@ -1,6 +1,6 @@
 [tool.poetry]
 name = "pycoustic"
-version = "0.1.2"
+version = "0.1.3"
 description = ""
 authors = ["thumpercastle <tony.ryb@gmail.com>"]
 readme = "README.md"
@@ -10,7 +10,7 @@ python = "^3.10"
 pandas = "2.2.3"
 numpy = "2.2.6"
 openpyxl = "3.1.5"
-streamlit = "1.46.0"
+requests = "^2.32.4"
 
 
 [build-system]

pycoustic-0.1.2/PKG-INFO

@@ -1,19 +0,0 @@
-Metadata-Version: 2.3
-Name: pycoustic
-Version: 0.1.2
-Summary: 
-Author: thumpercastle
-Author-email: tony.ryb@gmail.com
-Requires-Python: >=3.10,<4.0
-Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.10
-Classifier: Programming Language :: Python :: 3.11
-Classifier: Programming Language :: Python :: 3.12
-Classifier: Programming Language :: Python :: 3.13
-Requires-Dist: numpy (==2.2.6)
-Requires-Dist: openpyxl (==3.1.5)
-Requires-Dist: pandas (==2.2.3)
-Requires-Dist: streamlit (==1.46.0)
-Description-Content-Type: text/markdown
-
-

pycoustic-0.1.2/pycoustic/__init__.py

@@ -1,2 +0,0 @@
-from .log import Log
-from .survey import Survey