Getting started

Install the alpha

Use Python 3.10 or newer and a virtual environment:

python -m venv .venv
# macOS/Linux:
source .venv/bin/activate
# Windows PowerShell instead: .venv\Scripts\Activate.ps1
python -m pip install 'Protspect[ml,wavelets]==0.1.0a2'

The core package needs NumPy, SciPy, and pandas. The ml extra adds sklearn; wavelets adds PyWavelets; validation adds plotting and research utilities. There are no implicit AAindex downloads. For an editable checkout, clone the repository and run python -m pip install -e '.[ml,wavelets,validation]'.

For notebooks also install:

python -m pip install jupyterlab nbformat nbclient ipykernel
python -m jupyter lab

The first alpha, 0.1.0a1, retains the older Fourier API. The tutorials require 0.1.0a2 or newer. Alpha APIs may change.

Make your first table

from protspect import SequenceSet

dataset = SequenceSet(method="fourier", compute_cross_spectra=False)
dataset.from_sequence_list(["ACDE", "ACDF"], length=8,
    attributes={"id": ["peptide-1", "peptide-2"]})
table = dataset.export_features("amplitude", attributes=["id"])
assert table.shape == (2, 161)  # ID + 20 channels × 8 bins
assert list(table.id) == ["peptide-1", "peptide-2"]

Inputs are case-sensitive. Unknown residues, empty sequences, mismatched pair counts, and grids shorter than a chain raise errors. Clean and validate your sequence alphabet deliberately rather than silently replacing unknown residues.

Switch transforms

from protspect import transform_sequence

wavelet = transform_sequence("ACDE", method="wavelet", length=16,
    wavelet="haar", level=2, mode="periodization")
values, names = wavelet.features("real")
assert values.shape == (320,)
assert set(wavelet.coordinates["band"]) == {"A2", "D2", "D1"}

For sets and sklearn, backend options go in transform_options. Components, selection, and product export use the same conventions for all methods.

Choose a learning path