ZINC:Command language: Difference between revisions

From DISI
Jump to navigation Jump to search
m (9 revisions)
 
 
(6 intermediate revisions by 2 users not shown)
Line 1: Line 1:
You can control ZINC-12 remotely by hand writing URLs.  This document is a guide to how to use them.
You can control ZINC-12 remotely by hand writing URLs.  This document is a guide to how to use them. A subset of these qualify as RESTful.  There are more pages about controlling ZINC via various kinds of APIs we've experimented with at [[ZINC api]].


URLs are generally of the form:  http://zinc.docking.org/results?category.field=argument&category2.field2=argument2
URLs are generally of the form:  http://zinc.docking.org/results?category.field=argument&category2.field2=argument2
Line 5: Line 5:
Multiple queries and format instructions may be supplied in a single transaction.  
Multiple queries and format instructions may be supplied in a single transaction.  


{{TOCright}}
= Quick Search Bar =
= Quick Search Bar =
You can access all the functionality of the [[Quick Search Bar]] using the /find/ command.   
You can access all the functionality of the [[Quick Search Bar]] (QSB) using the /find/ command to form a valid RESTful query.   


  e.g.  http://zinc.docking.org/find/12346+3432+3343    ; search for 3 ZINC IDs
  e.g.  http://zinc.docking.org/find/12346+3432+3343    ; search for 3 ZINC IDs
  e.g.  http://zinc.docking.org/find/drug:ibuprofen            ; interpreted as in the interactive Quick Search Bar
  e.g.  http://zinc.docking.org/find/drug:ibuprofen            ; interpreted as in the interactive Quick Search Bar


The commands supported in the QSB  (before the :, no spaces)  in the quick search bar are  zinc, cas, smiles, drug, target, catalog and vendor. See the [[QSB]] article for examples.


= Structure =
= Structure =
Line 60: Line 60:


  e.g. http://zinc.docking.org/results?annotation.name=DRD2_HUMAN&filter.purchasability=purchasable
  e.g. http://zinc.docking.org/results?annotation.name=DRD2_HUMAN&filter.purchasability=purchasable
== Complete list of supported purchasability types ==
* purchasable
* stock-demand  = in stock OR make on demand
* in-stock
* on-demand
* boutique
* not-for-sale
* annotated
* modelsystems
* collabocules
* all
* jfk = boutique
== Complete list of supported page/report formats ==
* list
* compact
* summary
* basic
* targets
* ratings
* properties
* purchasing-info
* sdf
* smiles
* mol2
* db
* zinc
* 800-lb-gorilla
and for completeness
* chimera
* pymol
* marvin
* ijchem
These last 4 don't really make sense in a wget/curl context, and are really there for future support and/or nonstandard browser support.
[[Category:ZINC]]
[[Category:ZINC]]
[[Category:API]]

Latest revision as of 21:34, 28 December 2018

You can control ZINC-12 remotely by hand writing URLs. This document is a guide to how to use them. A subset of these qualify as RESTful. There are more pages about controlling ZINC via various kinds of APIs we've experimented with at ZINC api.

URLs are generally of the form: http://zinc.docking.org/results?category.field=argument&category2.field2=argument2

Multiple queries and format instructions may be supplied in a single transaction.

Quick Search Bar

You can access all the functionality of the Quick Search Bar (QSB) using the /find/ command to form a valid RESTful query. 

e.g.  http://zinc.docking.org/find/12346+3432+3343    ; search for 3 ZINC IDs
e.g.  http://zinc.docking.org/find/drug:ibuprofen            ; interpreted as in the interactive Quick Search Bar

The commands supported in the QSB (before the :, no spaces) in the quick search bar are zinc, cas, smiles, drug, target, catalog and vendor. See the QSB article for examples.

Structure

The SMILES and SMARTS must be URL encoded. 

structure.similarity=n where 0<=n<=1
structure.smiles=<SMILES>
structure.substructure=<SMARTS>

e.g. http://zinc.docking.org/results.?structure.smiles=C1CCCCC1&structure.similarity=1.0   ; search for exactly cyclohexane

Catalog

catalog.purchasability={not-for-sale, in-stock, on-demand, boutique, agent, collabocules>
catalog.name=<name>

e.g. http://zinc.docking.org/results?catalog.purchasablity=in-stock
e.g. http://zinc.docking.org/results?catalog.name=:ChemBridge,Molport

ZINC ID

zinc.id =

e.g.http://zinc.docking.org/results?zinc.id=29323

Annotation

annotation.swiss_prot=Q9R297
annotation.uniprot=HRH1_HUMAN
annotation.term=:Q9R297,HRH1_HUMAN

e.g.http://zinc.docking.org/results?annotation.uniprot=HRH1_HUMAN

Prediction

prediction.swiss_prot=Q9R297
prediction.uniprot=HRH1_HUMAN

 e.g.http://zinc.docking.org/results?prediction.swissprot=Q112345

Clustered Targets

target.code=drd2-1-e

e.g.http://zinc.docking.org/results?target.code=drd2-1-e

Reports, Formats, Filters

page.format=X where X = sdf, mol2, smi, Flexibase
filter.representation=X where X= usual, single, metal, all, ref, mid, hi, lo
filter.purchasability=X where X= in-stock, on-demand, purchasable, not-for-sale, all, ...

e.g. http://zinc.docking.org/results?annotation.name=DRD2_HUMAN&filter.purchasability=purchasable


Complete list of supported purchasability types

  • purchasable
  • stock-demand = in stock OR make on demand
  • in-stock
  • on-demand
  • boutique
  • not-for-sale
  • annotated
  • modelsystems
  • collabocules
  • all
  • jfk = boutique

Complete list of supported page/report formats

  • list
  • compact
  • summary
  • basic
  • targets
  • ratings
  • properties
  • purchasing-info
  • sdf
  • smiles
  • mol2
  • db
  • zinc
  • 800-lb-gorilla

and for completeness

  • chimera
  • pymol
  • marvin
  • ijchem

These last 4 don't really make sense in a wget/curl context, and are really there for future support and/or nonstandard browser support.

Retrieved from "http://wiki.docking.org/index.php?title=ZINC:Command_language&oldid=11213"