DeepSP icon

DeepSP

(commit 86cd81d)Code (opens in a new tab)Paper (opens in a new tab)Docs

Generate 30 sequence-derived spatial descriptors for paired antibody variable domains.

Output

Configure inputs to begin

Set options on the left, then click “Submit job”.

DeepSP online server

The DeepSP online server predicts 30 antibody spatial descriptors from paired heavy-chain and light-chain variable-domain sequences. ProteinIQ accepts a CSV of antibody pairs and returns spatial aggregation propensity and spatial charge map descriptors, numbering tables, aligned model inputs, FASTA files, logs, and provenance. No local installation or model setup is required.

The published models were trained using 20,530 antibody sequences. Across the 30 descriptors, the study reported an average correlation of 0.87 between DeepSP predictions and descriptors calculated from molecular dynamics trajectories, with individual correlations ranging from 0.76 to 0.96. This validation applies to the modeled spatial descriptors, not to direct experimental stability measurements.

Pricing

DeepSP jobs start at 20 credits. The calculator scales with the number of antibody pairs in the submitted CSV, with larger batches receiving sublinear pricing. The exact credit price is calculated before submission.

Inputs

The CSV header is case-sensitive. Extra columns are accepted and ignored.

ColumnRequiredDescription
NameYesUnique text identifier for the paired antibody. Duplicate names can collapse into one result row.
Heavy_ChainYesHeavy-chain variable-domain amino acid sequence.
Light_ChainYesKappa or lambda light-chain variable-domain amino acid sequence.
csv
Name,Heavy_Chain,Light_Chain
antibody_1,EVQLVESGGGLVQPGGSLRLSC...,DIQMTQSPSSLSASVGDRVTITC...

One job accepts up to 100 antibody rows and 1 MiB of CSV text. Larger datasets can be divided across multiple jobs. Sequence fields must remain valid text values when parsed from CSV, and blank required values are rejected before submission.

Settings

DeepSP has no adjustable scientific settings in ProteinIQ. It uses the published fixed inference workflow:

SettingValue
Antibody numberingANARCII with IMGT numbering
Model representationFixed 272-position paired representation, 145 heavy-chain positions and 127 light-chain positions
ModelsThree published convolutional neural networks, one for each descriptor family
Job nameOptional label used to identify the ProteinIQ job

Outputs

ResultDescription
Spatial descriptorsInteractive table containing Name and all 30 predicted descriptor values.
DeepSP_descriptors_anarci2.csvNative DeepSP descriptor table.
seq_aligned_H2_imgt.csvHeavy-chain IMGT numbering and alignment table.
seq_aligned_KL2_imgt.csvLight-chain IMGT numbering and alignment table.
seq_H.fasta and seq_L.fastaHeavy-chain and light-chain FASTA inputs generated by the source workflow.
seq_aligned_HL2.txtPaired 272-position model input used for inference.
Submitted input, logs, and provenanceOriginal CSV, source diagnostics, execution log, and exact source, model, runtime, and artifact provenance.

The numbering and alignment files are especially useful when a sequence produces unexpected descriptor values. They show how the submitted variable domains were mapped into the fixed model representation. ANARCII can be used separately when a more focused numbering analysis is needed.

How DeepSP works

DeepSP first numbers the paired variable domains with ANARCII using the IMGT scheme. The numbered heavy and light chains are mapped into a fixed 272-position representation and one-hot encoded with 21 residue symbols. Three convolutional neural networks then predict 10 regional values each, producing 30 descriptors in total.

Descriptor familyRegions returned
SAP_posCDRH1, CDRH2, CDRH3, CDRL1, CDRL2, CDRL3, CDR, Hv, Lv, Fv
SCM_negCDRH1, CDRH2, CDRH3, CDRL1, CDRL2, CDRL3, CDR, Hv, Lv, Fv
SCM_posCDRH1, CDRH2, CDRH3, CDRL1, CDRL2, CDRL3, CDR, Hv, Lv, Fv

SAP_pos is the source model's positive spatial aggregation propensity descriptor family. SCM_neg and SCM_pos are its negative and positive spatial charge map descriptor families. The regional suffix identifies the source-defined antibody region summarized by each value. Hv, Lv, and Fv refer to the heavy variable domain, light variable domain, and paired variable fragment.

Interpreting DeepSP descriptors

DeepSP values are model-derived spatial features. The source does not publish physical units, universal thresholds, confidence intervals, or a general higher-is-better direction for the 30 outputs. Values are most useful as consistent features for comparison or downstream modeling when the same input preparation and model edition are used across the compared antibodies.

The publication demonstrates that these sequence-based predictions reproduce molecular-dynamics-derived spatial descriptors and uses them as features in downstream aggregation modeling. It does not establish each descriptor as a direct measurement of experimental stability, aggregation rate, viscosity, or solubility. Interpretation should include sequence context, numbering quality, formulation conditions, and relevant experimental evidence.

Important limitations

  • Predictions depend on successful ANARCII numbering and the fixed 272-position representation. Unusual or incomplete variable-domain sequences should be reviewed with the numbering tables and source diagnostics.

  • Duplicate values in the Name column can collapse into one result row because DeepSP groups sequence records by name. Unique identifiers are required when every submitted row must remain distinct.

  • The hosted job limit is 100 antibody pairs and 1 MiB of CSV text. This is a ProteinIQ execution limit, not a scientific limit of the DeepSP models.

  • DeepSP does not return per-prediction confidence scores or uncertainty estimates.

  • Results from different model editions, numbering implementations, or preprocessing pipelines should not be assumed to be directly interchangeable without validation.

Table of contents

Related tools

DeepViscosity

DeepViscosity

Screen paired antibody Fv sequences for high-concentration viscosity risk.

TNP

TNP

Characterize nanobody developability with sequence, structure, and surface-property metrics.

EvoIF

EvoIF

Score single and multi-site protein mutations with evolutionary and inverse-folding profiles.

PolyXpert

PolyXpert

Screen paired antibody variable domains for low or high polyreactivity.

RaSP

RaSP

Predict protein stability changes across single amino acid substitutions.

ThermoMPNN

ThermoMPNN

Predict mutation ΔΔG values and identify stabilizing substitutions for protein engineering.

Aggrescan3D

Aggrescan3D

Analyze aggregation-prone regions in a protein structure.

Molecular descriptors

Molecular descriptors

Calculate RDKit physicochemical descriptors, drug-likeness scores, rule violations, and structural fingerprints from SMILES.

PROPKA 3

PROPKA 3

Predict pKa values of ionizable groups in proteins based on 3D structure.

AllMetal3D

AllMetal3D

Predict metal and water binding sites in proteins with 3D CNN models.