scikit-sampling 0.1.0__py3-none-any.whl

scikit_sampling-0.1.0.dist-info/METADATA

@@ -0,0 +1,60 @@
+Metadata-Version: 2.4
+Name: scikit-sampling
+Version: 0.1.0
+Summary: A set of python modules for dataset sampling
+Author-email: Leonardo Moraes <leomaurodesenv@users.noreply.github.com>
+License-Expression: MIT
+Classifier: Intended Audience :: Science/Research
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python
+Classifier: Topic :: Scientific/Engineering
+Classifier: Development Status :: 4 - Beta
+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-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: scipy<2,>=1.15.0
+Provides-Extra: build
+Requires-Dist: setuptools<90,>=80.9.0; extra == "build"
+Dynamic: license-file
+
+# 🧪 Scikit-Sampling
+
+[![GitHub](https://img.shields.io/static/v1?label=Code&message=GitHub&color=blue&style=flat-square)](https://github.com/leomaurodesenv/scikit-sampling)
+[![MIT license](https://img.shields.io/static/v1?label=License&message=MIT&color=blue&style=flat-square)](LICENSE)
+[![GitHub Workflow Status](https://img.shields.io/github/actions/workflow/status/leomaurodesenv/scikit-sampling/continuous-integration.yml?label=Build&style=flat-square)](https://github.com/leomaurodesenv/scikit-sampling/actions/workflows/continuous-integration.yml)
+
+
+Scikit-Sampling (or `sksampling`) is a Python library for dataset sampling techniques. It provides a unified API for common sampling strategies, making it easy to integrate into your data science and machine learning workflows.
+
+## Installation
+
+You can install `sksampling` using pip:
+
+```bash
+pip install scikit-sampling
+```
+
+## Features
+
+`sksampling` offers a range of sampling methods, including:
+
+- `sample_size`: Computes the ideal sample size based confidence level and interval.
+
+## Usage
+
+`sksampling` follows the `scikit-learn` API, making it intuitive to use.
+
+```python
+from sksampling import sample_size
+
+# Example usage
+population_size: int = 100_000
+confidence_level: float = 0.95
+confidence_interval: float = 0.02
+sample_size(population_size, confidence_level, confidence_interval) # approx 2345
+```

scikit_sampling-0.1.0.dist-info/RECORD

@@ -0,0 +1,6 @@
+scikit_sampling-0.1.0.dist-info/licenses/LICENSE,sha256=BuRfz6RXIKQR8frB2PtJIz6R6wqIHKmvmGg1aHRCzLg,1089
+sksampling/__init__.py,sha256=AUk6Srlfv6aBUbBzSis0cbVto4Y81615tUaq6QdAyBk,1331
+scikit_sampling-0.1.0.dist-info/METADATA,sha256=eRHUEjZMsboHwx9cF_WRspW0tWLMO0SosentTT5fo4Q,2280
+scikit_sampling-0.1.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+scikit_sampling-0.1.0.dist-info/top_level.txt,sha256=xE9a_qmMKqDdkQeQSUSgM-FZldsPmWeetW4RF1UgNsE,11
+scikit_sampling-0.1.0.dist-info/RECORD,,

scikit_sampling-0.1.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (80.9.0)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

scikit_sampling-0.1.0.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Leonardo Moraes <leomaurodesenv>
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

scikit_sampling-0.1.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+sksampling

sksampling/__init__.py

@@ -0,0 +1,44 @@
+import math
+import scipy.stats as st
+
+
+def _get_z_score(confidence_level: float) -> float:
+    """
+    Retrieves the Z-score for a given confidence level.
+
+    Args:
+        confidence_level: The confidence level as a float (e.g., 0.95 for 95%).
+
+    Returns:
+        The Z-score for the given confidence level.
+    """
+    return st.norm.ppf(1 - (1 - confidence_level) / 2)
+
+
+def sample_size(
+    population_size: int,
+    confidence_level: float = 0.95,
+    confidence_interval: float = 0.02,
+) -> int:
+    """
+    Calculates the sample size for a finite population using Cochran's formula.
+
+    Args:
+        population_size: The total size of the population.
+        confidence_level: The desired confidence level (e.g., 0.95 for 95%).
+        confidence_interval: The desired confidence interval (margin of error).
+                             Default is 0.02 (2%).
+
+    Returns:
+        The calculated sample size as an integer.
+    """
+
+    # For sample size calculation, we assume the worst-case variance, where p=0.5
+    p = 0.5
+    z_score = _get_z_score(confidence_level)
+    # Calculate sample size for an infinite population
+    n_0 = (z_score**2 * p * (1 - p)) / (confidence_interval**2)
+    # Adjust sample size for the finite population
+    n = n_0 / (1 + (n_0 - 1) / population_size)
+
+    return int(math.ceil(n))