Dataset Tools¶

Configuration File: dataset_tools.json Tool Type: Local Tools Count: 7

This page contains all tools defined in the dataset_tools.json configuration file.

Available Tools¶

dict_search (Type: DatasetTool)¶

Search the DICTrank dataset for drug-induced cardiotoxicity (DICT) risk information by trade name


dict_search tool specification

Tool Information:

  • Name: dict_search

  • Type: DatasetTool

  • Description: Search the DICTrank dataset for drug-induced cardiotoxicity (DICT) risk information by trade name, generic name, or active ingredient. Searching with exact match is not recommeded.

Parameters:

  • query (string) (optional) Free-text query (e.g. ‘ZYPREXA’, ‘Olanzapine’).

  • search_fields (array) (optional) Columns to search. Choose from: ‘Trade Name’, ‘Generic/Proper Name(s)’, ‘Active Ingredient(s)’.

  • case_sensitive (boolean) (optional) Match text with exact case if true.

  • exact_match (boolean) (optional) Field value must equal query exactly if true; otherwise substring match.

  • limit (integer) (optional) Maximum number of rows to return.

Example Usage:

query = {
    "name": "dict_search",
    "arguments": {
    }
}
result = tu.run(query)

dili_search (Type: DatasetTool)¶

Search the DILIrank dataset for drug-induced liver-injury (DILI) risk information by compound nam


dili_search tool specification

Tool Information:

  • Name: dili_search

  • Type: DatasetTool

  • Description: Search the DILIrank dataset for drug-induced liver-injury (DILI) risk information by compound name. Searching with exact match is not recommeded.

Parameters:

  • query (string) (optional) Free-text query (e.g. ‘acetaminophen’).

  • search_fields (array) (optional) Columns to search. Choose from: ‘Compound Name’.

  • case_sensitive (boolean) (optional) Match text with exact case if true.

  • exact_match (boolean) (optional) Field value must equal query exactly if true; otherwise substring match.

  • limit (integer) (optional) Maximum number of rows to return.

Example Usage:

query = {
    "name": "dili_search",
    "arguments": {
    }
}
result = tu.run(query)

diqt_search (Type: DatasetTool)¶

Search the DIQTA dataset for drug-induced QT-interval prolongation risk information by generic na


diqt_search tool specification

Tool Information:

  • Name: diqt_search

  • Type: DatasetTool

  • Description: Search the DIQTA dataset for drug-induced QT-interval prolongation risk information by generic name or DrugBank ID. Searching with exact match is not recommeded for generic name.

Parameters:

  • query (string) (optional) Free-text query (e.g. ‘Astemizole’, ‘DB00637’).

  • search_fields (array) (optional) Columns to search. Choose from: ‘Generic/Proper Name(s)’, ‘DrugBank ID’.

  • case_sensitive (boolean) (optional) Match text with exact case if true.

  • exact_match (boolean) (optional) Field value must equal query exactly if true; otherwise substring match.

  • limit (integer) (optional) Maximum number of rows to return.

Example Usage:

query = {
    "name": "diqt_search",
    "arguments": {
    }
}
result = tu.run(query)

drugbank_full_search (Type: DatasetTool)¶

Search the cleaned DrugBank dataframe (one row per drug) by ID, common name, or synonym. Returns 


drugbank_full_search tool specification

Tool Information:

  • Name: drugbank_full_search

  • Type: DatasetTool

  • Description: Search the cleaned DrugBank dataframe (one row per drug) by ID, common name, or synonym. Returns identifiers, ATC, main pharmacology text fields, and protein partners. For best results, it is recommended that one uses drugbank_vocab_search to obtain DrugBank ID from other keywords first, and use this tool with DrugBank ID.

Parameters:

  • query (string) (optional) Free-text query (e.g. ‘DB00945’, ‘acetylsalicylic’, ‘Acarbosa’).

  • search_fields (array) (optional) Columns to search in. Choose from: ‘drugbank_id’, ‘name’, ‘synonyms’.

  • case_sensitive (boolean) (optional) Match text with exact case if true.

  • exact_match (boolean) (optional) Field value must equal query exactly if true; otherwise substring match.

  • limit (integer) (optional) Max number of rows to return.

Example Usage:

query = {
    "name": "drugbank_full_search",
    "arguments": {
    }
}
result = tu.run(query)

drugbank_vocab_filter (Type: DatasetTool)¶

Filter the DrugBank vocabulary dataset based on specific field criteria. Use simple field-value p


drugbank_vocab_filter tool specification

Tool Information:

  • Name: drugbank_vocab_filter

  • Type: DatasetTool

  • Description: Filter the DrugBank vocabulary dataset based on specific field criteria. Use simple field-value pairs to filter drugs by properties like names, IDs, and chemical identifiers.

Parameters:

  • field (string) (optional) The field to filter on

  • condition (string) (optional) The type of filtering condition to apply. Filter is case-insensitive.

  • value (string) (optional) The value to filter by. Not required when condition is ‘not_empty’. Examples: ‘insulin’ (for contains), ‘DB00’ (for starts_with), ‘acid’ (for ends_with), ‘Aspirin’ (for exact)

  • limit (integer) (optional) Maximum number of results to return.

Example Usage:

query = {
    "name": "drugbank_vocab_filter",
    "arguments": {
    }
}
result = tu.run(query)

drugbank_vocab_search (Type: DatasetTool)¶

Search the DrugBank vocabulary dataset for drugs by name, ID, synonyms, or other fields using tex


drugbank_vocab_search tool specification

Tool Information:

  • Name: drugbank_vocab_search

  • Type: DatasetTool

  • Description: Search the DrugBank vocabulary dataset for drugs by name, ID, synonyms, or other fields using text-based queries. Returns detailed drug information including DrugBank ID, common name, CAS number, UNII, and synonyms.

Parameters:

  • query (string) (optional) Search query string. Can be drug name, synonym, DrugBank ID, or any text to search for.

  • search_fields (array) (optional) Fields to search in. Available fields: ‘DrugBank ID’, ‘Accession Numbers’, ‘Common name’, ‘CAS’, ‘UNII’, ‘Synonyms’, ‘Standard InChI Key’.

  • case_sensitive (boolean) (optional) Whether the search should be case sensitive.

  • exact_match (boolean) (optional) Whether to perform exact matching instead of substring matching.

  • limit (integer) (optional) Maximum number of results to return.

Example Usage:

query = {
    "name": "drugbank_vocab_search",
    "arguments": {
    }
}
result = tu.run(query)