ZINC26: Difference between revisions

From DISI
Jump to navigation Jump to search
No edit summary
Line 30: Line 30:
     - catalog — e.g. dball (from /sw/maps)
     - catalog — e.g. dball (from /sw/maps)
     - smiles — your query molecule in SMILES notation
     - smiles — your query molecule in SMILES notation
   Optional distance parameters (all default to 0 or 4):
   Optional distance parameters:
     - ced — chemical edit distance (default 4)
     - ced — chemical edit distance (0 to 4, default to 4)
     - ged — graph edit distance (default 4)
     - ged — graph edit distance (0 to 2, default to 2)
     - terminalUp, terminalDown, ringUp, ringDown, linkerUp, linkerDown
     - terminalUp (0 to 8, default to 4)
     - mutationMajor, mutationMinor, hybridisation, substitution
    - terminalDown (0 to 8, default to 4)
    - ringUp (0 to 8, default to 2)
    - ringDown (0 to 8, default to 2)
    - linkerUp (0 to 8, default to 2)
    - linkerDown (0 to 8, default to 2)
     - mutationMajor (0 to 8, default to 4)
    - mutationMinor (0 to 8, default to 4)
    - hybridisation (0 to 8, default to 4)
    - substitution (0 to 8, default to 4)


* Response:
* Response:
     {"task_id": "abc-123", "status": "PENDING"}
     {"task_id": "abc-123", "status": "PENDING"}
==== Step 3 : Check for results ====
==== Step 3 : Check for results ====
* Command
* Command

Revision as of 22:03, 12 August 2026

Introduction

ZINC26 is a search tool for purchasable chemical space. It uses Smallworld and Arthor technology from NextMove Software to allow searching billions of molecules in seconds. There is a batch interface and an interactive one.

The new database is organized around a set of principles.

API

  • zinc26.docking.org/docs describes how to use. Here is a short tutorial to get you started using curl

SW search API

Step 1 : Check available databases/categories/catalogs

  • Command
curl "https://zinc26.docking.org/sw/maps"

  • Response:
{"Bioactive":
   {"inVitro":
     ["00chembl","mapsAADAC","mapsAADAT","mapsAAK1","mapsABAT"]
   }
}


Step 2 : Submit a search

  • Command
curl "https://zinc26.docking.org/sw/search?database=Bioact&category=inVivo&catalog=dball&smiles=CCCCC&ced=4&ged=2&terminalUp=4&terminalDown=4&ringUp=2&ringDown=4&linkerUp=2&linkerDown=2&mutationMajor=4&mutationMinor=4&hybridisation=4&substitution=4&atomAlignment=true&multiSource=false"
 Required parameters:
   - database — e.g. Purchasable, Bioact
   - category — e.g. inVivo (from /sw/maps)
   - catalog — e.g. dball (from /sw/maps)
   - smiles — your query molecule in SMILES notation
 Optional distance parameters:
   - ced — chemical edit distance (0 to 4, default to 4)
   - ged — graph edit distance (0 to 2, default to 2)
   - terminalUp (0 to 8, default to 4)
   - terminalDown (0 to 8, default to 4)
   - ringUp (0 to 8, default to 2)
   - ringDown (0 to 8, default to 2)
   - linkerUp (0 to 8, default to 2)
   - linkerDown (0 to 8, default to 2)
   - mutationMajor (0 to 8, default to 4)
   - mutationMinor (0 to 8, default to 4)
   - hybridisation (0 to 8, default to 4)
   - substitution (0 to 8, default to 4)
  • Response:
   {"task_id": "abc-123", "status": "PENDING"}

Step 3 : Check for results

  • Command
curl "https://zinc26.docking.org/sw/result?task_id=abc-123"
  • Response
Poll this until status is SUCCESS (or FAILURE). While running it may return PROGRESS with partial results:
  {
     "task_id": "abc-123",
     "status": "SUCCESS",
     "results": [...]
   }


Arthor search API

Batch Job search API

Coming soon

  • 3d database builder
  • additional data

Tutorial in how to use datawarrior

  • the columns in datawarrior are as follows.
  • we are still working on adding a net_charge column.
  • we suggest you proceed as follows.