PyPI - qdesc - Versions diffs - 0.1.5__tar.gz → 0.1.6__tar.gz - Mend

qdesc 0.1.5tar.gz → 0.1.6tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Potentially problematic release.

This version of qdesc might be problematic. Click here for more details.

Files changed (10) hide show

{qdesc-0.1.5/qdesc.egg-info → qdesc-0.1.6}/PKG-INFO RENAMED Viewed

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: qdesc
-Version: 0.1.5
+Version: 0.1.6
 Summary: Quick and Easy way to do descriptive analysis.
 Author: Paolo Hilado
 Author-email: datasciencepgh@proton.me
@@ -21,6 +21,7 @@ Be sure to run the following prior to using the "qd.desc" function:
 The qdesc package provides a quick and easy approach to do descriptive analysis for quantitative data.
+## qd.desc Function
 Run the function qd.desc(df) to get the following statistics:
 * count - number of observations
 * mean - measure of central tendency for normal distribution
@@ -33,17 +34,25 @@ Run the function qd.desc(df) to get the following statistics:
 * 5% crit_value - critical value for a 5% Significance Level
 * 1% crit_value - critical value for a 1% Significance Level
+## qd.freqdist Function
 Run the function qd.freqdist(df, "Variable Name") to easily create a frequency distribution for your chosen categorical variable with the following:
 * Variable Levels (i.e., for Sex Variable: Male and Female)
 * Counts - the number of observations
 * Percentage - percentage of observations from total.
+## qd.freqdist_a Function
 Run the function qd.freqdist_a(df, ascending = FALSE) to easily create frequency distribution tables, arranged in descending manner (default) or ascending (TRUE), for all
 the categorical variables in your data frame. The resulting table will include columns such as:
 * Variable levels (i.e., for Satisfaction: Very Low, Low, Moderate, High, Very High)
 * Counts - the number of observations
 * Percentage - percentage of observations from total.
+## qd.freqdist_to_excel Function
+Run the function qd.freqdist_to_excel(df, "Name of file.xlsx", ascending = FALSE ) to easily create frequency distribution tables, arranged in descending manner (default) or ascending (TRUE), for all  the categorical variables in your data frame and SAVED as separate sheets in the .xlsx File. The resulting table will include columns such as:
+* Variable levels (i.e., for Satisfaction: Very Low, Low, Moderate, High, Very High)
+* Counts - the number of observations
+* Percentage - percentage of observations from total.
 Later versions will include data visualizations handy for exploring the distribution of the data set.

qdesc-0.1.5/PKG-INFO → qdesc-0.1.6/README.md RENAMED Viewed

@@ -1,73 +1,73 @@
-Metadata-Version: 2.1
-Name: qdesc
-Version: 0.1.5
-Summary: Quick and Easy way to do descriptive analysis.
-Author: Paolo Hilado
-Author-email: datasciencepgh@proton.me
-Description-Content-Type: text/markdown
-License-File: LICENCE.txt
-# qdesc - Quick and Easy Descriptive Analysis
-## Overview
-This is a package for quick and easy descriptive analysis.
-Required packages include: pandas, numpy, and SciPy version 1.14.1
-Be sure to run the following prior to using the "qd.desc" function:
-- import pandas as pd
-- import numpy as np
-- from scipy.stats import anderson
-- import qdesc as qd
-The qdesc package provides a quick and easy approach to do descriptive analysis for quantitative data.
-Run the function qd.desc(df) to get the following statistics:
-* count - number of observations
-* mean - measure of central tendency for normal distribution
-* std - measure of spread for normal distribution
-* median - measure of central tendency for skewed distributions or those with outliers
-* MAD - measure of spread for skewed distributions or those with outliers; this is manual Median Absolute Deviation (MAD) which is more robust when dealing with non-normal distributions.
-* min - lowest observed value
-* max - highest observed value
-* AD_stat	- Anderson - Darling Statistic
-* 5% crit_value - critical value for a 5% Significance Level
-* 1% crit_value - critical value for a 1% Significance Level
-Run the function qd.freqdist(df, "Variable Name") to easily create a frequency distribution for your chosen categorical variable with the following:
-* Variable Levels (i.e., for Sex Variable: Male and Female)
-* Counts - the number of observations
-* Percentage - percentage of observations from total.
-Run the function qd.freqdist_a(df, ascending = FALSE) to easily create frequency distribution tables, arranged in descending manner (default) or ascending (TRUE), for all
-the categorical variables in your data frame. The resulting table will include columns such as:
-* Variable levels (i.e., for Satisfaction: Very Low, Low, Moderate, High, Very High)
-* Counts - the number of observations
-* Percentage - percentage of observations from total.
-Later versions will include data visualizations handy for exploring the distribution of the data set.
-## Installation
-pip install qdesc
-## Usage - doing descriptive analysis using qdesc
-### import qdesc as qd
-### qd.desc(df)
-## License
-This project is licensed under the GPL-3 License. See the LICENSE file for more details.
-## Acknowledgements
-Acknowledgement of the libraries used by this package...
-### Pandas
-Pandas is distributed under the BSD 3-Clause License, pandas is developed by Pandas contributors. Copyright (c) 2008-2024, the pandas development team All rights reserved.
-### NumPy
-NumPy is distributed under the BSD 3-Clause License, numpy is developed by NumPy contributors. Copyright (c) 2005-2024, NumPy Developers. All rights reserved.
-### SciPy
-SciPy is distributed under the BSD License, scipy is developed by SciPy contributors. Copyright (c) 2001-2024, SciPy Developers. All rights reserved.
+# qdesc - Quick and Easy Descriptive Analysis
+## Overview
+This is a package for quick and easy descriptive analysis.
+Required packages include: pandas, numpy, and SciPy version 1.14.1
+Be sure to run the following prior to using the "qd.desc" function:
+- import pandas as pd
+- import numpy as np
+- from scipy.stats import anderson
+- import qdesc as qd
+The qdesc package provides a quick and easy approach to do descriptive analysis for quantitative data.
+## qd.desc Function
+Run the function qd.desc(df) to get the following statistics:
+* count - number of observations
+* mean - measure of central tendency for normal distribution
+* std - measure of spread for normal distribution
+* median - measure of central tendency for skewed distributions or those with outliers
+* MAD - measure of spread for skewed distributions or those with outliers; this is manual Median Absolute Deviation (MAD) which is more robust when dealing with non-normal distributions.
+* min - lowest observed value
+* max - highest observed value
+* AD_stat	- Anderson - Darling Statistic
+* 5% crit_value - critical value for a 5% Significance Level
+* 1% crit_value - critical value for a 1% Significance Level
+## qd.freqdist Function
+Run the function qd.freqdist(df, "Variable Name") to easily create a frequency distribution for your chosen categorical variable with the following:
+* Variable Levels (i.e., for Sex Variable: Male and Female)
+* Counts - the number of observations
+* Percentage - percentage of observations from total.
+## qd.freqdist_a Function
+Run the function qd.freqdist_a(df, ascending = FALSE) to easily create frequency distribution tables, arranged in descending manner (default) or ascending (TRUE), for all
+the categorical variables in your data frame. The resulting table will include columns such as:
+* Variable levels (i.e., for Satisfaction: Very Low, Low, Moderate, High, Very High)
+* Counts - the number of observations
+* Percentage - percentage of observations from total.
+## qd.freqdist_to_excel Function
+Run the function qd.freqdist_to_excel(df, "Name of file.xlsx", ascending = FALSE ) to easily create frequency distribution tables, arranged in descending manner (default) or ascending (TRUE), for all  the categorical variables in your data frame and SAVED as separate sheets in the .xlsx File. The resulting table will include columns such as:
+* Variable levels (i.e., for Satisfaction: Very Low, Low, Moderate, High, Very High)
+* Counts - the number of observations
+* Percentage - percentage of observations from total.
+Later versions will include data visualizations handy for exploring the distribution of the data set.
+## Installation
+pip install qdesc
+## Usage - doing descriptive analysis using qdesc
+### import qdesc as qd
+### qd.desc(df)
+## License
+This project is licensed under the GPL-3 License. See the LICENSE file for more details.
+## Acknowledgements
+Acknowledgement of the libraries used by this package...
+### Pandas
+Pandas is distributed under the BSD 3-Clause License, pandas is developed by Pandas contributors. Copyright (c) 2008-2024, the pandas development team All rights reserved.
+### NumPy
+NumPy is distributed under the BSD 3-Clause License, numpy is developed by NumPy contributors. Copyright (c) 2005-2024, NumPy Developers. All rights reserved.
+### SciPy
+SciPy is distributed under the BSD License, scipy is developed by SciPy contributors. Copyright (c) 2001-2024, SciPy Developers. All rights reserved.

{qdesc-0.1.5 → qdesc-0.1.6}/qdesc/__init__.py RENAMED Viewed

@@ -68,3 +68,36 @@ def freqdist_a(df, ascending=False):
         results.append(distribution)
     final_df = pd.concat(results, ignore_index=True)
     return final_df
+def clean_sheet_name(name):
+    # Remove invalid characters
+    name = re.sub(r'[:\\/?*\[\]]', '', name)
+    # Limit to 31 characters
+    name = name.strip()[:31]
+    return name
+def freqdist_to_excel(df, output_path, sort_by='Percentage', ascending=False, top_n=None):
+    used_names = set()
+    with pd.ExcelWriter(output_path, engine='xlsxwriter') as writer:
+        for column in df.select_dtypes(include=['object', 'category']).columns:
+            frequency_table = df[column].value_counts()
+            percentage_table = df[column].value_counts(normalize=True) * 100
+            distribution = pd.DataFrame({
+                'Value': frequency_table.index,
+                'Count': frequency_table.values,
+                'Percentage': percentage_table.values
+            })
+            distribution = distribution.sort_values(by=sort_by, ascending=ascending)
+            if top_n is not None:
+                distribution = distribution.head(top_n)
+            # Generate safe sheet name
+            base_name = clean_sheet_name(column)
+            sheet_name = base_name
+            count = 1
+            while sheet_name.lower() in used_names:
+                sheet_name = f"{base_name[:28]}_{count}"  # stay within 31 char limit
+                count += 1
+            used_names.add(sheet_name.lower())
+            distribution.to_excel(writer, sheet_name=sheet_name, index=False)
+    print(f"Frequency distributions written to {output_path}")

qdesc-0.1.5/README.md → qdesc-0.1.6/qdesc.egg-info/PKG-INFO RENAMED Viewed

@@ -1,64 +1,82 @@
-# qdesc - Quick and Easy Descriptive Analysis
-## Overview
-This is a package for quick and easy descriptive analysis.
-Required packages include: pandas, numpy, and SciPy version 1.14.1
-Be sure to run the following prior to using the "qd.desc" function:
-- import pandas as pd
-- import numpy as np
-- from scipy.stats import anderson
-- import qdesc as qd
-The qdesc package provides a quick and easy approach to do descriptive analysis for quantitative data.
-Run the function qd.desc(df) to get the following statistics:
-* count - number of observations
-* mean - measure of central tendency for normal distribution
-* std - measure of spread for normal distribution
-* median - measure of central tendency for skewed distributions or those with outliers
-* MAD - measure of spread for skewed distributions or those with outliers; this is manual Median Absolute Deviation (MAD) which is more robust when dealing with non-normal distributions.
-* min - lowest observed value
-* max - highest observed value
-* AD_stat	- Anderson - Darling Statistic
-* 5% crit_value - critical value for a 5% Significance Level
-* 1% crit_value - critical value for a 1% Significance Level
-Run the function qd.freqdist(df, "Variable Name") to easily create a frequency distribution for your chosen categorical variable with the following:
-* Variable Levels (i.e., for Sex Variable: Male and Female)
-* Counts - the number of observations
-* Percentage - percentage of observations from total.
-Run the function qd.freqdist_a(df, ascending = FALSE) to easily create frequency distribution tables, arranged in descending manner (default) or ascending (TRUE), for all
-the categorical variables in your data frame. The resulting table will include columns such as:
-* Variable levels (i.e., for Satisfaction: Very Low, Low, Moderate, High, Very High)
-* Counts - the number of observations
-* Percentage - percentage of observations from total.
-Later versions will include data visualizations handy for exploring the distribution of the data set.
-## Installation
-pip install qdesc
-## Usage - doing descriptive analysis using qdesc
-### import qdesc as qd
-### qd.desc(df)
-## License
-This project is licensed under the GPL-3 License. See the LICENSE file for more details.
-## Acknowledgements
-Acknowledgement of the libraries used by this package...
-### Pandas
-Pandas is distributed under the BSD 3-Clause License, pandas is developed by Pandas contributors. Copyright (c) 2008-2024, the pandas development team All rights reserved.
-### NumPy
-NumPy is distributed under the BSD 3-Clause License, numpy is developed by NumPy contributors. Copyright (c) 2005-2024, NumPy Developers. All rights reserved.
-### SciPy
-SciPy is distributed under the BSD License, scipy is developed by SciPy contributors. Copyright (c) 2001-2024, SciPy Developers. All rights reserved.
+Metadata-Version: 2.1
+Name: qdesc
+Version: 0.1.6
+Summary: Quick and Easy way to do descriptive analysis.
+Author: Paolo Hilado
+Author-email: datasciencepgh@proton.me
+Description-Content-Type: text/markdown
+License-File: LICENCE.txt
+# qdesc - Quick and Easy Descriptive Analysis
+## Overview
+This is a package for quick and easy descriptive analysis.
+Required packages include: pandas, numpy, and SciPy version 1.14.1
+Be sure to run the following prior to using the "qd.desc" function:
+- import pandas as pd
+- import numpy as np
+- from scipy.stats import anderson
+- import qdesc as qd
+The qdesc package provides a quick and easy approach to do descriptive analysis for quantitative data.
+## qd.desc Function
+Run the function qd.desc(df) to get the following statistics:
+* count - number of observations
+* mean - measure of central tendency for normal distribution
+* std - measure of spread for normal distribution
+* median - measure of central tendency for skewed distributions or those with outliers
+* MAD - measure of spread for skewed distributions or those with outliers; this is manual Median Absolute Deviation (MAD) which is more robust when dealing with non-normal distributions.
+* min - lowest observed value
+* max - highest observed value
+* AD_stat	- Anderson - Darling Statistic
+* 5% crit_value - critical value for a 5% Significance Level
+* 1% crit_value - critical value for a 1% Significance Level
+## qd.freqdist Function
+Run the function qd.freqdist(df, "Variable Name") to easily create a frequency distribution for your chosen categorical variable with the following:
+* Variable Levels (i.e., for Sex Variable: Male and Female)
+* Counts - the number of observations
+* Percentage - percentage of observations from total.
+## qd.freqdist_a Function
+Run the function qd.freqdist_a(df, ascending = FALSE) to easily create frequency distribution tables, arranged in descending manner (default) or ascending (TRUE), for all
+the categorical variables in your data frame. The resulting table will include columns such as:
+* Variable levels (i.e., for Satisfaction: Very Low, Low, Moderate, High, Very High)
+* Counts - the number of observations
+* Percentage - percentage of observations from total.
+## qd.freqdist_to_excel Function
+Run the function qd.freqdist_to_excel(df, "Name of file.xlsx", ascending = FALSE ) to easily create frequency distribution tables, arranged in descending manner (default) or ascending (TRUE), for all  the categorical variables in your data frame and SAVED as separate sheets in the .xlsx File. The resulting table will include columns such as:
+* Variable levels (i.e., for Satisfaction: Very Low, Low, Moderate, High, Very High)
+* Counts - the number of observations
+* Percentage - percentage of observations from total.
+Later versions will include data visualizations handy for exploring the distribution of the data set.
+## Installation
+pip install qdesc
+## Usage - doing descriptive analysis using qdesc
+### import qdesc as qd
+### qd.desc(df)
+## License
+This project is licensed under the GPL-3 License. See the LICENSE file for more details.
+## Acknowledgements
+Acknowledgement of the libraries used by this package...
+### Pandas
+Pandas is distributed under the BSD 3-Clause License, pandas is developed by Pandas contributors. Copyright (c) 2008-2024, the pandas development team All rights reserved.
+### NumPy
+NumPy is distributed under the BSD 3-Clause License, numpy is developed by NumPy contributors. Copyright (c) 2005-2024, NumPy Developers. All rights reserved.
+### SciPy
+SciPy is distributed under the BSD License, scipy is developed by SciPy contributors. Copyright (c) 2001-2024, SciPy Developers. All rights reserved.

{qdesc-0.1.5 → qdesc-0.1.6}/setup.py RENAMED Viewed

@@ -7,7 +7,7 @@ long_description = (this_directory / "README.md").read_text()
 setup(
     name='qdesc',
-    version='0.1.5',
+    version='0.1.6',
     packages=find_packages(),
     install_requires=[
         # List your dependencies here, e.g., pandas if your function requires it

{qdesc-0.1.5 → qdesc-0.1.6}/LICENCE.txt RENAMED Viewed

File without changes

{qdesc-0.1.5 → qdesc-0.1.6}/qdesc.egg-info/SOURCES.txt RENAMED Viewed

File without changes

{qdesc-0.1.5 → qdesc-0.1.6}/qdesc.egg-info/dependency_links.txt RENAMED Viewed

File without changes

{qdesc-0.1.5 → qdesc-0.1.6}/qdesc.egg-info/top_level.txt RENAMED Viewed

File without changes

{qdesc-0.1.5 → qdesc-0.1.6}/setup.cfg RENAMED Viewed

File without changes

qdesc 0.1.5__tar.gz → 0.1.6__tar.gz

Potentially problematic release.

qdesc 0.1.5tar.gz → 0.1.6tar.gz