Skip to main content

    Interpreting RXNFP outputs

    A 256-dimensional float vector per reaction, matches ranked by cosine similarity, and the score bands from very similar to no meaningful similarity.

    rxnfpoutputs

    Fingerprinting returns one vector per reaction, and its shape follows the fingerprint_type you asked for: 256 floats for rxnfp, 2048 binary 0/1 values for drfp. Similarity search returns your query's fingerprint plus a ranked list of matching reactions. Use fingerprints as ML features or for your own downstream comparison; use similarity search to find known reactions like a novel one.

    ⛔ Record which fingerprint_type produced a stored vector or score. The two are not interchangeable and their similarity scores are not comparable, so a vector of unknown type is not reusable.

    Fingerprinting output

    Per reaction:

    FieldTypeDescription
    reaction_smilesstringThe input reaction SMILES.
    fingerprintnumber[]The vector: 256 floats under rxnfp, or 2048 binary values under drfp.
    is_validbooleanWhether the fingerprint was computed.
    errorstring | nullError message if is_valid is false.

    The job as a whole reports total_reactions, successful, failed, and processing_time_seconds alongside the per-reaction results array.

    {
      "reaction_smiles": "CC(=O)O.OCC>>CC(=O)OCC",
      "fingerprint": [0.0234, -0.1567, 0.0891, "...(256 values)"],
      "is_valid": true,
      "error": null
    }

    Similarity search output

    FieldTypeDescription
    query_smilesstringThe query reaction SMILES.
    query_fingerprintnumber[]The query's 256-D fingerprint.
    similar_reactionsarrayRanked matches from the reference index.
    similar_reactions[].indexintegerPosition in the reference index.
    similar_reactions[].similaritynumberCosine similarity, 0–1.
    similar_reactions[].reaction_smilesstring | nullThe matched reaction's SMILES, if available.
    similar_reactions[].reaction_namestring | nullNamed reaction type, if available.
    similar_reactions[].classificationstring | nullReaction classification, if available.

    Results are capped by top_k (default 10) and floored by min_similarity (default 0.7) — see inputs & parameters.

    Interpreting similarity scores

    Cosine similarity between two 256-D fingerprints:

    Score rangeInterpretation
    0.90 – 1.00Very similar transformations (same reaction type, similar substrates)
    0.70 – 0.90Related transformations (same reaction class, different substrates)
    0.40 – 0.70Moderate similarity (related functional-group chemistry)
    < 0.40Weak or no meaningful similarity

    Using fingerprints downstream

    Fingerprints are a plain float vector, so anything you do with them happens outside the platform:

    • Clustering: apply DBSCAN, k-means, or hierarchical clustering on a set of fingerprint vectors you've collected.
    • Visualization: project 256-D vectors to 2D with UMAP or t-SNE for a reaction-space map.
    • ML features: use fingerprints as input features for your own reaction-property models.

    Was this page helpful?

    On this page

    On this page

    Loading...