AeroViz 0.1.0__tar.gz → 0.1.1__tar.gz

{aeroviz-0.1.0 → aeroviz-0.1.1}/AeroViz/__init__.py

@@ -1,15 +1,12 @@
-# This file is used to import all the modules in the DataPlot package
+# This file is used to import all the modules in the AeroViz package
 from AeroViz import plot
 from AeroViz.dataProcess import Optical, SizeDistr, Chemistry, VOC
-from AeroViz.plot import Color, Unit, set_figure
-from AeroViz.process import DataProcess
 from AeroViz.rawDataReader import RawDataReader
 from AeroViz.tools import DataBase, DataReader, DataClassifier
 
 __all__ = [
 	'plot',
-	'Color', 'Unit', 'set_figure',
 	'RawDataReader',
 	'Optical', 'SizeDistr', 'Chemistry', 'VOC',
-	'DataProcess', 'DataBase', 'DataReader', 'DataClassifier',
+	'DataBase', 'DataReader', 'DataClassifier'
 ]

{aeroviz-0.1.0 → aeroviz-0.1.1}/AeroViz/plot/timeseries/timeseries.py

@@ -57,8 +57,6 @@ def _scatter(ax, df, _y, _c, scatter_kws, cbar_kws, inset_kws):
 		else:
 			print("No mappable objects found.")
 
-		# plt.colorbar(mappable=ax.get_children()[0], cax=cax, **cbar_kws)
-
 
 def _bar(ax, df, _y, _c, bar_kws, cbar_kws, inset_kws):
 	scalar_map, colors = Color.color_maker(df[_c].values, cmap=bar_kws.pop('cmap'))
@@ -85,7 +83,7 @@ def timeseries(df: DataFrame,
 			   c: list[str] | str = None,
 			   # color: list[str] | str = None,
 			   rolling: str | int | None = None,
-			   times: tuple[datetime | Timestamp | str, datetime | Timestamp | str] = None,
+			   times: list[datetime | Timestamp | str] = None,
 			   freq: str = '1MS',
 			   style: list[Literal['scatter', 'bar', 'line']] | str | None = None,
 			   ax: Axes | None = None,
@@ -149,7 +147,14 @@ def timeseries(df: DataFrame,
 	>>> timeseries(df, y='WS', c='WD', scatter_kws=dict(cmap='hsv'), cbar_kws=dict(ticks=[0, 90, 180, 270, 360]), ylim=[0, None])
 	"""
 	# Set the time
-	st_tm, fn_tm = (df.index[0], df.index[-1]) if times is None else map(Timestamp, times)
+
+	if times is not None:
+		st_tm, fn_tm = map(Timestamp, times)
+	else:
+		try:
+			st_tm, fn_tm = df.index[0], df.index[-1]
+		except IndexError:
+			raise IndexError("The DataFrame is empty. Please provide a valid DataFrame.")
 
 	# Apply rolling window if specified
 	df = df.loc[st_tm:fn_tm] if rolling is None else (
@@ -277,7 +282,7 @@ def timeseries_template(df: DataFrame) -> tuple[Figure, Axes]:
 			   ax=ax2,
 			   ax_plot_kws=dict(color='r'),
 			   ax2_plot_kws=dict(color='b'),
-			   ylim=[10, 40],
+			   ylim=[10, 30],
 			   ylim2=[20, 100],
 			   set_xaxis_visible=False,
 			   legend_ncol=2,
@@ -295,23 +300,3 @@ def timeseries_template(df: DataFrame) -> tuple[Figure, Axes]:
 	plt.show()
 
 	return fig, ax
-
-
-if __name__ == '__main__':
-	from AeroViz import *
-
-	df = DataBase('/Users/chanchihyu/NTU/2020能見度計畫/data/All_data.csv')
-
-	plot.timeseries.timeseries(df,
-							   y=['Extinction', 'Scattering', 'Absorption'],
-							   y2=['PBLH'],
-							   c=['PM25', None, None, None],
-							   style=['scatter', 'line', 'line', 'line'],
-							   times=('2020-10-01', '2020-11-30'), ylim=[0, None], ylim2=[0, None], rolling=50,
-							   inset_kws=dict(bbox_to_anchor=(1.12, 0, 1.2, 1)),
-							   legend_ncol=4)
-
-	# timeseries(df, y='WS', c='WD', style='scatter', times=('2020-10-01', '2020-11-30'), scatter_kws=dict(cmap='hsv'), cbar_kws=dict(ticks=[0, 90, 180, 270, 360]),
-	#            ylim=[0, None])
-
-	# timeseries_template(df.loc['2020-09-01':'2020-12-31'])

{aeroviz-0.1.0 → aeroviz-0.1.1}/AeroViz/rawDataReader/core/__init__.py

@@ -2,6 +2,7 @@ import json as jsn
 import pickle as pkl
 from abc import ABC, abstractmethod
 from datetime import datetime as dtm, timedelta as dtmdt
+from itertools import chain
 from pathlib import Path
 
 import numpy as np
@@ -229,7 +230,9 @@ class AbstractReader(ABC):
 
 	# read raw data
 	def _read_raw(self, ):
-		_df_con, _f_list = None, list(self.path.glob(self.meta['pattern']))
+		pattern = self.meta['pattern']
+		patterns = {pattern, pattern.lower(), pattern.upper()}
+		_df_con, _f_list = None, list(chain.from_iterable(self.path.glob(p) for p in patterns))
 
 		for file in _f_list:
 			if file.name in [self.csv_out, self.csv_nam, self.csv_nam_raw, f'{self.nam}.log']:

aeroviz-0.1.1/AeroViz/rawDataReader/script/NEPH.py

@@ -0,0 +1,80 @@
+from pandas import to_datetime, read_csv, DataFrame
+
+from AeroViz.rawDataReader.core import AbstractReader
+
+
+class Reader(AbstractReader):
+	nam = 'NEPH'
+
+	def _raw_reader(self, _file):
+		with _file.open('r', encoding='utf-8', errors='ignore') as f:
+			_df = read_csv(f, header=None, names=range(11))
+
+			_df_grp = _df.groupby(0)
+
+			# T : time
+			_df_tm = _df_grp.get_group('T')[[1, 2, 3, 4, 5, 6]].astype(int)
+
+			for _k in [2, 3, 4, 5, 6]:
+				_df_tm[_k] = _df_tm[_k].astype(int).map('{:02d}'.format).copy()
+			_df_tm = _df_tm.astype(str)
+
+			_idx_tm = to_datetime((_df_tm[1] + _df_tm[2] + _df_tm[3] + _df_tm[4] + _df_tm[5] + _df_tm[6]),
+								  format='%Y%m%d%H%M%S')
+
+			# D : data
+			# col : 3~8 B G R BB BG BR
+			# 1e6
+			try:
+				_df_dt = _df_grp.get_group('D')[[1, 2, 3, 4, 5, 6, 7, 8]].set_index(_idx_tm)
+				_df_out = (_df_dt.groupby(1).get_group('NBXX')[[3, 4, 5, 6, 7, 8]] * 1e6).reindex(_idx_tm)
+				_df_out.columns = ['B', 'G', 'R', 'BB', 'BG', 'BR']
+				_df_out.index.name = 'Time'
+
+				# Y : state
+				# col : 5 RH
+				_df_st = _df_grp.get_group('Y')
+				_df_out['RH'] = _df_st[5].values
+				_df_out['status'] = _df_st[9].values
+
+				_df_out.mask(_df_out['status'] != 0)  # 0000 -> numeric to 0
+
+				return _df_out[['B', 'G', 'R', 'BB', 'BG', 'BR', 'RH']]
+
+			except ValueError:
+				group_sizes = _df_grp.size()
+				print(group_sizes)
+				# Define the valid groups
+				valid_groups = {'B', 'G', 'R', 'D', 'T', 'Y', 'Z'}
+
+				# Find the rows where the value in the first column is not in valid_groups
+				invalid_indices = _df[~_df[0].isin(valid_groups)].index
+
+				# Print the invalid indices and their corresponding values
+				invalid_values = _df.loc[invalid_indices, 0]
+				print("Invalid values and their indices:")
+				for idx, value in zip(invalid_indices, invalid_values):
+					print(f"Index: {idx}, Value: {value}")
+
+				# If there's a length mismatch, return an empty DataFrame with the same index and column names
+				columns = ['B', 'G', 'R', 'BB', 'BG', 'BR', 'RH']
+				_df_out = DataFrame(index=_idx_tm, columns=columns)
+				_df_out.index.name = 'Time'
+				print(f'\n\t\t\t Length mismatch in {_file} data. Returning an empty DataFrame.')
+				return _df_out
+
+	# QC data
+	def _QC(self, _df):
+		# remove negative value
+		_df = _df.mask((_df <= 0).copy())
+
+		# call by _QC function
+		# QC data in 1 hr
+		def _QC_func(_df_1hr):
+			_df_ave = _df_1hr.mean()
+			_df_std = _df_1hr.std()
+			_df_lowb, _df_highb = _df_1hr < (_df_ave - _df_std * 1.5), _df_1hr > (_df_ave + _df_std * 1.5)
+
+			return _df_1hr.mask(_df_lowb | _df_highb).copy()
+
+		return _df.resample('1h', group_keys=False).apply(_QC_func)

{aeroviz-0.1.0 → aeroviz-0.1.1}/AeroViz/tools/database.py

@@ -52,13 +52,14 @@ def load_dataset_by_url(dataset_name: Literal["Tunghai", "Taipei"] = "Tunghai")
 		return DataFrame()  # Return an empty DataFrame in case of failure
 
 
-def load_dataset_local(dataset_name: Literal["Tunghai", "Taipei"] = "Tunghai") -> DataFrame:
+def load_dataset_local(dataset_name: Literal["Tunghai", "Taipei", "PNSD"] = "Tunghai") -> DataFrame:
 	base_dir = Path(__file__).resolve().parent.parent
 	config_dir = base_dir / 'config'
 
 	dataset_paths = {
 		"Tunghai": config_dir / 'DEFAULT_DATA.csv',
 		"Taipei": config_dir / 'DEFAULT_DATA.csv',
+		"PNSD": config_dir / 'DEFAULT_PNSD_DATA.csv'
 	}
 
 	if dataset_name not in dataset_paths:
@@ -73,21 +74,23 @@ def load_dataset_local(dataset_name: Literal["Tunghai", "Taipei"] = "Tunghai") -
 
 
 class DataBase:
-	def __new__(cls, file_path=None):
-		file_path = Path(file_path) if file_path is not None else load_dataset_local
-
+	def __new__(cls, file_path: Path | str = None, load_data: bool = False, load_PSD: bool = False):
 		print(f'\t\t \033[96m --- Loading Data --- \033[0m')
+		if file_path is not None:
+			file_path = Path(file_path)
+			if file_path.exists():
+				return read_csv(file_path, parse_dates=['Time'], index_col='Time', na_values=('-', 'E', 'F'),
+								low_memory=False)
+
+		if load_data ^ load_PSD:
+			if load_data:
+				return load_dataset_local("Tunghai")
+
+			elif load_PSD:
+				return load_dataset_local("PNSD")
 
-		if file_path.exists():
-			return read_csv(file_path, parse_dates=['Time'], index_col='Time', na_values=('-', 'E', 'F'),
-							low_memory=False)
 		else:
-			use_default = input(
-				"The required file does not exist. Do you want to use default data? (yes/no): ").strip().lower()
-			if use_default == 'yes':
-				return load_dataset_local("Tunghai")
-			else:
-				raise FileNotFoundError("Required files are missing. Please process data to generate these files.")
+			raise ValueError("Exactly one of 'load_data' or 'load_PSD' must be True.")
 
 
 if __name__ == '__main__':

aeroviz-0.1.1/AeroViz/tools/dataprinter.py

@@ -0,0 +1,58 @@
+from datetime import datetime
+
+from pandas import DataFrame, Timestamp
+from tabulate import tabulate
+
+
+def data_table(df: DataFrame,
+			   items: list[str] | str = None,
+			   times: list[datetime | Timestamp | str] = None,
+			   ):
+	"""
+	This function cuts the DataFrame based on the given time periods and calculates the mean and standard deviation
+	of the specified items for each period.
+
+	Parameters
+	----------
+	df : pd.DataFrame
+		The DataFrame to be processed. It should have a DateTime index.
+	items : list[str] | str, optional
+		The columns of the DataFrame to be processed. It can be a list of column names or a single column name.
+		By default, it is ['NO', 'NO2', 'NOx'].
+	times : list[str] | str, optional
+		The time periods to cut the DataFrame. It can be a list of time strings or a single time string.
+		Each time string should be in the format of 'YYYY-MM-DD'. By default, it is ['2024-03-21', '2024-04-30'].
+
+	Returns
+	-------
+	None
+		This function doesn't return any value. It prints out a table showing the mean and standard deviation
+		of the specified items for each time period.
+	"""
+	items = [items] if isinstance(items, str) else items
+	times = [times] if isinstance(times, str) else times
+	times = list(map(Timestamp, times))
+
+	times.sort()
+
+	results = []
+	periods = []
+	for i in range(len(times) + 1):
+		if i == 0:
+			df_period = df.loc[df.index <= times[i], items]
+			period_label = f'Before {times[i].date()}'
+		elif i == len(times):
+			df_period = df.loc[df.index > times[i - 1], items]
+			period_label = f'After {times[i - 1].date()}'
+		else:
+			df_period = df.loc[(df.index > times[i - 1]) & (df.index <= times[i]), items]
+			period_label = f'{times[i - 1].date()} to {times[i].date()}'
+
+		mean, std = df_period.mean().round(2).to_numpy(), df_period.std().round(2).to_numpy()
+
+		results.append([f'{m} ± {s}' for m, s in zip(mean, std)])
+		periods.append(period_label)
+
+	result = DataFrame(results, columns=items, index=periods)
+
+	print(tabulate(result, headers='keys', tablefmt='fancy_grid'))

aeroviz-0.1.1/AeroViz.egg-info/PKG-INFO

@@ -0,0 +1,123 @@
+Metadata-Version: 2.1
+Name: AeroViz
+Version: 0.1.1
+Summary: Aerosol science
+Home-page: https://github.com/Alex870521/AeroViz
+Author: alex
+Author-email: alex870521@gmail.com
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.12
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: pandas
+Requires-Dist: numpy
+Requires-Dist: matplotlib
+Requires-Dist: seaborn
+Requires-Dist: scipy
+Requires-Dist: scikit-learn
+Requires-Dist: windrose
+Requires-Dist: tabulate
+
+## <div align="center">AeroViz for Aerosol Science Visualization</div>
+
+<p align="center">
+
+  <img alt="Static Badge" src="https://img.shields.io/badge/python-3.12-blue?logo=python">
+  <img alt="Static Badge" src="https://img.shields.io/badge/License-MIT-yellow">
+  <img alt="Static Badge" src="https://img.shields.io/badge/github-updating-red?logo=github">
+  <img src="https://img.shields.io/badge/testing-green?logo=Pytest&logoColor=blue">
+
+</p>
+
+<div align="center">
+
+<a href="https://github.com/Alex870521"><img src="https://github.com/Alex870521/AeroViz/blob/main/assets/media/logo-social-github.png?raw=true" width="3%" alt="Alex870521 GitHub"></a>
+<img src="https://github.com/Alex870521/AeroViz/blob/main/assets/media/logo-transparent.png?raw=true" width="3%">
+<a href="https://www.linkedin.com/in/Alex870521/"><img src="https://github.com/Alex870521/AeroViz/blob/main/assets/media/logo-social-linkedin.png?raw=true" width="3%" alt="Alex870521 LinkedIn"></a>
+<img src="https://github.com/Alex870521/AeroViz/blob/main/assets/media/logo-transparent.png?raw=true" width="3%">
+<a href="https://medium.com/@alex870521"><img src="https://github.com/Alex870521/AeroViz/blob/main/assets/media/logo-social-medium.png?raw=true" width="3%" alt="Alex870521 Medium"></a>
+
+
+</div>
+
+## <div align="center">Installation</div>
+
+```bash
+pip install AeroViz # ensure the python version is >= 3.12
+```
+
+## <div align="center">Usage</div>
+
+```python
+import AeroViz
+```
+
+## <div align="center">RawDataReader Supported Instruments</div>
+
+> [!NOTE]\
+> We are continuously working to support more instruments. Please check back for updates or contribute to our project on
+> GitHub.
+
+The AeroViz project currently supports data from the following instruments:
+
+- **SMPS (Scanning Mobility Particle Sizer)**
+- **APS (Aerodynamic Particle Sizer)**
+- **GRIMM (GRIMM Aerosol Technik)**
+- **TEOM (Continuous Ambient Particulate Monitor)**
+- **NEPH (Nephelometer)**
+- **Aurora (Nephelometer)**
+- **AE33 (Aethalometer Model 33)**
+- **AE43 (Aethalometer Model 43)**
+- **BC1054 (Black Carbon Monitor 1054)**
+- **MA350 (MicroAeth MA350)**
+- **OCEC (Organic Carbon Elemental Carbon Analyzer)**
+- **IGAC (In-situ Gas and Aerosol Compositions monitor)**
+- **VOC (Volatile Organic Compounds Monitor)**
+
+## <div align="center">DataProcess Supported Method</div>
+
+The AeroViz project currently supports the following processing methods:
+
+- **Chemistry**
+- **Optical**
+- **SizeDistr**
+- **VOC**
+
+## <div align="center">Documentation</div>
+
+For detailed documentation, please refer to the `docs` folder, which includes:
+
+<div align="center">
+
+| Documentation                              | Description                |
+|--------------------------------------------|----------------------------|
+| [User Guide](docs/user_guide.md)           | Basic usage instructions   |
+| [Developer Guide](docs/developer_guide.md) | Developer guidelines       |
+| [API Reference](docs/api_reference.md)     | API documentation          |
+| [FAQ](docs/faq.md)                         | Frequently Asked Questions |
+| [Changelog](docs/changelog.md)             | List of changes            |
+
+</div>
+
+## <div align="center">Related Dependencies</div>
+
+* #### [PyMieScatt](https://github.com/bsumlin/PyMieScatt.git)
+* #### [py-smps](https://github.com/quant-aq/py-smps.git)
+* #### [ContainerHandle](https://github.com/yrr-Su/ContainerHandle.git)
+
+## <div align="center">Contact</div>
+
+For bug reports and feature requests please visit [GitHub Issues](https://github.com/Alex870521/DataPlot/issues).
+
+<div align="center">
+
+<a href="https://github.com/Alex870521"><img src="https://github.com/Alex870521/assets_repo/blob/main/assets/media/logo-social-github.png?raw=true" width="3%" alt="Alex870521 GitHub"></a>
+<img src="https://github.com/Alex870521/assets_repo/blob/main/assets/media/logo-transparent.png?raw=true" width="3%">
+<a href="https://www.linkedin.com/in/Alex870521/"><img src="https://github.com/Alex870521/assets_repo/blob/main/assets/media/logo-social-linkedin.png?raw=true" width="3%" alt="Alex870521 LinkedIn"></a>
+<img src="https://github.com/Alex870521/assets_repo/blob/main/assets/media/logo-transparent.png?raw=true" width="3%">
+<a href="https://medium.com/@alex870521"><img src="https://github.com/Alex870521/assets_repo/blob/main/assets/media/logo-social-medium.png?raw=true" width="3%" alt="Alex870521 Medium"></a>
+
+
+</div>

{aeroviz-0.1.0 → aeroviz-0.1.1}/AeroViz.egg-info/SOURCES.txt

@@ -102,5 +102,6 @@ AeroViz/rawDataReader/script/__init__.py
 AeroViz/tools/__init__.py
 AeroViz/tools/database.py
 AeroViz/tools/dataclassifier.py
+AeroViz/tools/dataprinter.py
 AeroViz/tools/datareader.py
 tests/test_plot.py

aeroviz-0.1.1/PKG-INFO

@@ -0,0 +1,123 @@
+Metadata-Version: 2.1
+Name: AeroViz
+Version: 0.1.1
+Summary: Aerosol science
+Home-page: https://github.com/Alex870521/AeroViz
+Author: alex
+Author-email: alex870521@gmail.com
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.12
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: pandas
+Requires-Dist: numpy
+Requires-Dist: matplotlib
+Requires-Dist: seaborn
+Requires-Dist: scipy
+Requires-Dist: scikit-learn
+Requires-Dist: windrose
+Requires-Dist: tabulate
+
+## <div align="center">AeroViz for Aerosol Science Visualization</div>
+
+<p align="center">
+
+  <img alt="Static Badge" src="https://img.shields.io/badge/python-3.12-blue?logo=python">
+  <img alt="Static Badge" src="https://img.shields.io/badge/License-MIT-yellow">
+  <img alt="Static Badge" src="https://img.shields.io/badge/github-updating-red?logo=github">
+  <img src="https://img.shields.io/badge/testing-green?logo=Pytest&logoColor=blue">
+
+</p>
+
+<div align="center">
+
+<a href="https://github.com/Alex870521"><img src="https://github.com/Alex870521/AeroViz/blob/main/assets/media/logo-social-github.png?raw=true" width="3%" alt="Alex870521 GitHub"></a>
+<img src="https://github.com/Alex870521/AeroViz/blob/main/assets/media/logo-transparent.png?raw=true" width="3%">
+<a href="https://www.linkedin.com/in/Alex870521/"><img src="https://github.com/Alex870521/AeroViz/blob/main/assets/media/logo-social-linkedin.png?raw=true" width="3%" alt="Alex870521 LinkedIn"></a>
+<img src="https://github.com/Alex870521/AeroViz/blob/main/assets/media/logo-transparent.png?raw=true" width="3%">
+<a href="https://medium.com/@alex870521"><img src="https://github.com/Alex870521/AeroViz/blob/main/assets/media/logo-social-medium.png?raw=true" width="3%" alt="Alex870521 Medium"></a>
+
+
+</div>
+
+## <div align="center">Installation</div>
+
+```bash
+pip install AeroViz # ensure the python version is >= 3.12
+```
+
+## <div align="center">Usage</div>
+
+```python
+import AeroViz
+```
+
+## <div align="center">RawDataReader Supported Instruments</div>
+
+> [!NOTE]\
+> We are continuously working to support more instruments. Please check back for updates or contribute to our project on
+> GitHub.
+
+The AeroViz project currently supports data from the following instruments:
+
+- **SMPS (Scanning Mobility Particle Sizer)**
+- **APS (Aerodynamic Particle Sizer)**
+- **GRIMM (GRIMM Aerosol Technik)**
+- **TEOM (Continuous Ambient Particulate Monitor)**
+- **NEPH (Nephelometer)**
+- **Aurora (Nephelometer)**
+- **AE33 (Aethalometer Model 33)**
+- **AE43 (Aethalometer Model 43)**
+- **BC1054 (Black Carbon Monitor 1054)**
+- **MA350 (MicroAeth MA350)**
+- **OCEC (Organic Carbon Elemental Carbon Analyzer)**
+- **IGAC (In-situ Gas and Aerosol Compositions monitor)**
+- **VOC (Volatile Organic Compounds Monitor)**
+
+## <div align="center">DataProcess Supported Method</div>
+
+The AeroViz project currently supports the following processing methods:
+
+- **Chemistry**
+- **Optical**
+- **SizeDistr**
+- **VOC**
+
+## <div align="center">Documentation</div>
+
+For detailed documentation, please refer to the `docs` folder, which includes:
+
+<div align="center">
+
+| Documentation                              | Description                |
+|--------------------------------------------|----------------------------|
+| [User Guide](docs/user_guide.md)           | Basic usage instructions   |
+| [Developer Guide](docs/developer_guide.md) | Developer guidelines       |
+| [API Reference](docs/api_reference.md)     | API documentation          |
+| [FAQ](docs/faq.md)                         | Frequently Asked Questions |
+| [Changelog](docs/changelog.md)             | List of changes            |
+
+</div>
+
+## <div align="center">Related Dependencies</div>
+
+* #### [PyMieScatt](https://github.com/bsumlin/PyMieScatt.git)
+* #### [py-smps](https://github.com/quant-aq/py-smps.git)
+* #### [ContainerHandle](https://github.com/yrr-Su/ContainerHandle.git)
+
+## <div align="center">Contact</div>
+
+For bug reports and feature requests please visit [GitHub Issues](https://github.com/Alex870521/DataPlot/issues).
+
+<div align="center">
+
+<a href="https://github.com/Alex870521"><img src="https://github.com/Alex870521/assets_repo/blob/main/assets/media/logo-social-github.png?raw=true" width="3%" alt="Alex870521 GitHub"></a>
+<img src="https://github.com/Alex870521/assets_repo/blob/main/assets/media/logo-transparent.png?raw=true" width="3%">
+<a href="https://www.linkedin.com/in/Alex870521/"><img src="https://github.com/Alex870521/assets_repo/blob/main/assets/media/logo-social-linkedin.png?raw=true" width="3%" alt="Alex870521 LinkedIn"></a>
+<img src="https://github.com/Alex870521/assets_repo/blob/main/assets/media/logo-transparent.png?raw=true" width="3%">
+<a href="https://medium.com/@alex870521"><img src="https://github.com/Alex870521/assets_repo/blob/main/assets/media/logo-social-medium.png?raw=true" width="3%" alt="Alex870521 Medium"></a>
+
+
+</div>

aeroviz-0.1.1/README.md

@@ -0,0 +1,101 @@
+## <div align="center">AeroViz for Aerosol Science Visualization</div>
+
+<p align="center">
+
+  <img alt="Static Badge" src="https://img.shields.io/badge/python-3.12-blue?logo=python">
+  <img alt="Static Badge" src="https://img.shields.io/badge/License-MIT-yellow">
+  <img alt="Static Badge" src="https://img.shields.io/badge/github-updating-red?logo=github">
+  <img src="https://img.shields.io/badge/testing-green?logo=Pytest&logoColor=blue">
+
+</p>
+
+<div align="center">
+
+<a href="https://github.com/Alex870521"><img src="https://github.com/Alex870521/AeroViz/blob/main/assets/media/logo-social-github.png?raw=true" width="3%" alt="Alex870521 GitHub"></a>
+<img src="https://github.com/Alex870521/AeroViz/blob/main/assets/media/logo-transparent.png?raw=true" width="3%">
+<a href="https://www.linkedin.com/in/Alex870521/"><img src="https://github.com/Alex870521/AeroViz/blob/main/assets/media/logo-social-linkedin.png?raw=true" width="3%" alt="Alex870521 LinkedIn"></a>
+<img src="https://github.com/Alex870521/AeroViz/blob/main/assets/media/logo-transparent.png?raw=true" width="3%">
+<a href="https://medium.com/@alex870521"><img src="https://github.com/Alex870521/AeroViz/blob/main/assets/media/logo-social-medium.png?raw=true" width="3%" alt="Alex870521 Medium"></a>
+
+
+</div>
+
+## <div align="center">Installation</div>
+
+```bash
+pip install AeroViz # ensure the python version is >= 3.12
+```
+
+## <div align="center">Usage</div>
+
+```python
+import AeroViz
+```
+
+## <div align="center">RawDataReader Supported Instruments</div>
+
+> [!NOTE]\
+> We are continuously working to support more instruments. Please check back for updates or contribute to our project on
+> GitHub.
+
+The AeroViz project currently supports data from the following instruments:
+
+- **SMPS (Scanning Mobility Particle Sizer)**
+- **APS (Aerodynamic Particle Sizer)**
+- **GRIMM (GRIMM Aerosol Technik)**
+- **TEOM (Continuous Ambient Particulate Monitor)**
+- **NEPH (Nephelometer)**
+- **Aurora (Nephelometer)**
+- **AE33 (Aethalometer Model 33)**
+- **AE43 (Aethalometer Model 43)**
+- **BC1054 (Black Carbon Monitor 1054)**
+- **MA350 (MicroAeth MA350)**
+- **OCEC (Organic Carbon Elemental Carbon Analyzer)**
+- **IGAC (In-situ Gas and Aerosol Compositions monitor)**
+- **VOC (Volatile Organic Compounds Monitor)**
+
+## <div align="center">DataProcess Supported Method</div>
+
+The AeroViz project currently supports the following processing methods:
+
+- **Chemistry**
+- **Optical**
+- **SizeDistr**
+- **VOC**
+
+## <div align="center">Documentation</div>
+
+For detailed documentation, please refer to the `docs` folder, which includes:
+
+<div align="center">
+
+| Documentation                              | Description                |
+|--------------------------------------------|----------------------------|
+| [User Guide](docs/user_guide.md)           | Basic usage instructions   |
+| [Developer Guide](docs/developer_guide.md) | Developer guidelines       |
+| [API Reference](docs/api_reference.md)     | API documentation          |
+| [FAQ](docs/faq.md)                         | Frequently Asked Questions |
+| [Changelog](docs/changelog.md)             | List of changes            |
+
+</div>
+
+## <div align="center">Related Dependencies</div>
+
+* #### [PyMieScatt](https://github.com/bsumlin/PyMieScatt.git)
+* #### [py-smps](https://github.com/quant-aq/py-smps.git)
+* #### [ContainerHandle](https://github.com/yrr-Su/ContainerHandle.git)
+
+## <div align="center">Contact</div>
+
+For bug reports and feature requests please visit [GitHub Issues](https://github.com/Alex870521/DataPlot/issues).
+
+<div align="center">
+
+<a href="https://github.com/Alex870521"><img src="https://github.com/Alex870521/assets_repo/blob/main/assets/media/logo-social-github.png?raw=true" width="3%" alt="Alex870521 GitHub"></a>
+<img src="https://github.com/Alex870521/assets_repo/blob/main/assets/media/logo-transparent.png?raw=true" width="3%">
+<a href="https://www.linkedin.com/in/Alex870521/"><img src="https://github.com/Alex870521/assets_repo/blob/main/assets/media/logo-social-linkedin.png?raw=true" width="3%" alt="Alex870521 LinkedIn"></a>
+<img src="https://github.com/Alex870521/assets_repo/blob/main/assets/media/logo-transparent.png?raw=true" width="3%">
+<a href="https://medium.com/@alex870521"><img src="https://github.com/Alex870521/assets_repo/blob/main/assets/media/logo-social-medium.png?raw=true" width="3%" alt="Alex870521 Medium"></a>
+
+
+</div>

{aeroviz-0.1.0 → aeroviz-0.1.1}/setup.py

@@ -2,7 +2,7 @@ from setuptools import setup, find_packages
 
 setup(
 	name="AeroViz",
-	version="0.1.0",
+	version="0.1.1",
 	author="alex",
 	author_email="alex870521@gmail.com",
 	description="Aerosol science",