Type Preserving Scaler
type_preserving_scaler provides a small wrapper around scikit-learn's
StandardScaler for projects that want predictable output container types.
What it is
The package exposes one class:
from type_preserving_scaler import StandardScalerThatPreservesInputType
StandardScalerThatPreservesInputType behaves like
sklearn.preprocessing.StandardScaler, with one added convention:
- fit on a pandas
DataFrame, andtransform()/fit_transform()return a pandasDataFrame - fit on a NumPy array, and
transform()/fit_transform()return a NumPyndarray
For DataFrame inputs, the tested behavior preserves the output shape, columns, and index.
Why it exists
Plain StandardScaler can return NumPy arrays even when the caller is working
with pandas data. That can force downstream code to manually rebuild DataFrames
or carry column/index metadata separately.
This package keeps the common "pandas in, pandas out" workflow while retaining
the familiar StandardScaler API.
How it works
The class subclasses sklearn.preprocessing.StandardScaler. During fit(), it
delegates to the parent scaler, then calls scikit-learn's set_output() API:
set_output(transform="pandas")whenfit()receives a pandasDataFrameset_output(transform="default")otherwise
The output type is therefore determined by the data passed to fit(), not by
each later call to transform().
Installation
pip install type_preserving_scaler
The package requires Python 3.8 or newer and depends on NumPy, pandas, and scikit-learn.
Usage
import pandas as pd
from type_preserving_scaler import StandardScalerThatPreservesInputType
df = pd.DataFrame({"a": [1, 2, 3], "b": [10, 20, 30]})
scaler = StandardScalerThatPreservesInputType()
scaled = scaler.fit_transform(df)
assert isinstance(scaled, pd.DataFrame)
assert scaled.columns.equals(df.columns)
assert scaled.index.equals(df.index)
NumPy inputs keep NumPy outputs:
import numpy as np
from type_preserving_scaler import StandardScalerThatPreservesInputType
array = np.array([[1.0, 2.0], [3.0, 4.0]])
scaled = StandardScalerThatPreservesInputType().fit_transform(array)
assert isinstance(scaled, np.ndarray)
Development
Install the development dependencies and the package in editable mode:
pip install -r requirements_dev.txt
pip install -e .
Common local commands:
make test
make lint
make docs
Limitations
- This package only wraps
StandardScaler; it is not a general adapter for all scikit-learn transformers. - The output type is chosen when
fit()runs. - The installed scikit-learn version must provide the
set_output()API used by the implementation. - The package preserves the output container type. It does not change
StandardScaler's scaling behavior.
License
MIT.
Changelog
0.0.1
- First release on PyPI.
Metadata
Release files for type-preserving-scaler 0.0.2
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| type_preserving_scaler-0.0.2.tar.gz | 12.1 kB | Without provenance | Details for type_preserving_scaler-0.0.2.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| type_preserving_scaler-0.0.2-py2.py3-none-any.whl | Python 3, Python 2 | none | any | Details for type_preserving_scaler-0.0.2-py2.py3-none-any.whl |
Total release size: 16.7 kB
Release files / type_preserving_scaler-0.0.2.tar.gz
| Download URL | type_preserving_scaler-0.0.2.tar.gz |
|---|---|
| Size | 12.1 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
eb789ecaa90d66b124fab9a7d07fcafb701ed2c75e9ffa9553459c9145ac5a85
|
|
BLAKE2b-256 checksum How to use checksums |
f28f3a430a7d247c3a46ddf3f45c20b5a1af7c848639c729c6f55aeca95530bc
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.9.25
|
Release files / type_preserving_scaler-0.0.2-py2.py3-none-any.whl
| Download URL | type_preserving_scaler-0.0.2-py2.py3-none-any.whl |
|---|---|
| Size | 4.6 kB |
| Tags | Python 2 Python 3 |
|
SHA-256 checksum How to use checksums |
cb22e75c452c53042435be1224904f299d6a38ea76ca839c8495d7bffb5b110e
|
|
BLAKE2b-256 checksum How to use checksums |
f2bcceeb94cb6f02e53bc1db01c38105d2dbdf585136cc720503a04a3984ee78
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.9.25
|
Security for type-preserving-scaler 0.0.2
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.