Help & Documentation

This page provides guidance on the use of the Thai PGx Landscape platform, enabling users to access, analyze, and interpret pharmacogenomic data accurately and efficiently. The platform is designed to support multiple user groups, including researchers, clinical personnel, and individuals with an interest in pharmacogenomics.

Getting Started

Users may begin by registering and logging in through a user account. Upon authentication, the Home page serves as the entry point for accessing the platform's functional modules.

1
Register for a user account or log in if an account has already been created.
2
Navigate to the Home page, which provides access to all available modules.
3
Select the desired module — Genes, Drugs, Variants, HLA-ADR, Samples, or Statistics — to begin exploring pharmacogenomic data.
4
Use the search and filter functions within each module to retrieve data relevant to your query.

Platform Modules

The platform comprises six functional modules, each addressing a specific dimension of pharmacogenomic data. The following section provides detailed usage instructions for each module, including available filters, result formats, and navigation to detail views.

🧬
Genes
Gene explorer
Search and retrieve information on pharmacogenes associated with drug response, including gene-level details, phenotype associations, and dosing guidance. The Genes module enables users to search for pharmacogenes by name and apply filtering criteria to refine the result set.
Filtering Criteria
  • •Gene Function — Carriers, Enzymes, Targets, Transporters
  • •CPIC Guideline Availability — With or without CPIC guideline
  • •Gene Category — HLA, Non-HLA
Gene Detail Tabs
  • •Information — Gene description, external database links, related genes
  • •Phenotype — Diplotype frequency with population proportions
  • •CPIC Dosing Guideline — Phenotype-linked prescribing recommendations
  • •Variant Effect — Variant impact data
💊
Drugs
Drug–gene links
Search for drugs and examine their associations with relevant pharmacogenes, including drug details, genetic analysis results, and clinical prescribing recommendations. The Drugs module enables users to search for drugs by name and apply filters to narrow results.
Filtering Criteria
  • •NLEM Status — In NLEM, Not in NLEM
  • •Therapeutic Class — Anti-infectives, Cardiovascular system, Nervous system, and others
  • •CPIC Guideline Availability — With or without CPIC guideline
Drug Detail Tabs
  • •Information — Drug description and associated gene groups
  • •Phenotype — Gene-linked phenotype distributions
  • •Recommendation — Use as directed / Use with caution / Avoid use
  • •CPIC Dosing Guideline — Phenotype-linked dosing guidance
🔍
Variants
Variant browser
Search and filter genetic variants based on user-defined criteria, including variant type, functional significance, and gene association. Users may search by gene name or rsID.
Filtering Criteria
  • •Consequences — Gene Location, Intron/mRNA/Protein/Splice/UTR Modifications, and others
  • •Impact — HIGH, MODERATE, LOW, MODIFIER
  • •Thai Allele Frequency — Range filter
  • •Compared Population — ALL, AFR, AMI, AMR, ASJ, EAS, FIN, MID, NFE, SAS
  • •Significant Level — p-value range filter
Table Column Groups
  • •Sequence Position — cDNA position, CDS position, Protein position, Amino acids, Codons, Existing variation
  • •Impact & Prediction Scores — Impact, PolyPhen, SIFT, CADD, GeTH AF
  • •gnomAD Allele Frequencies — ALL, AFR, AMI, AMR, ASJ, EAS, FIN, MID, NFE, SAS
  • •gnomAD Adjusted p-Values — p-ALL, p-AFR, p-AMI, p-AMR, p-ASJ, p-EAS, p-FIN, p-MID
🛡️
HLA-ADR
Drug safety
Explore associations between HLA gene alleles and adverse drug reactions, with access to supporting research evidence for each reported association. Results are displayed as collapsible rows grouped by HLA allele.
Filtering Criteria
  • •Gene — HLA-A, HLA-B, HLA-C, HLA-DQA1, HLA-DQB1, HLA-DRB1, and others
  • •Drug — Allopurinol, Carbamazepine, Abacavir, Phenytoin, and others
  • •ADR — SJS, TEN, DILI, Hypersensitivity reactions, and others
  • •Ethnicity — Asian, European, East Asian, Southeast Asian, and others
  • •Disease — Epilepsy, HIV, Gout, and others
  • •Thai Allele Frequency — Range filter
  • •P-value / Odds Ratio — Statistical evidence filters
👥
Samples
Population data
Search and filter population sample data based on specified attributes, displaying matching sample counts and characteristics. The Samples module allows users to explore population-level data by applying a single filtering condition at a time.
Filtering Criteria
  • •Phenotype — Normal, Altered, Intermediate, Likely Intermediate, Poor, Possible Intermediate, Rapid, Ultrarapid metabolizer
  • •Genotype — Select a gene and optionally specify a haplotype or allele
  • •Drug Recommendation — Use as directed, Use with caution, Avoid use
Result Formats
  • •Phenotype selected — Gene list with related sample count and percentage
  • •Genotype selected — Summary with total related sample count and charts by gender and region
  • •Drug Recommendation selected — Drug list with related sample count and percentage
📊
Statistics
Summary & visualization
View aggregated statistical analysis results presented as charts and visualizations summarizing population-level pharmacogenomic data.
Summary & Demographic Charts
  • •Summary Counts — Total Samples, Drugs, and Genes
  • •Gender Distribution — Donut chart of sample sex composition
  • •Region Chart — Donut chart by Thai regional distribution
  • •Geo Map Chart — Geographic distribution on a Thailand map
Pharmacogenomic & Variant Charts
  • •Gene Phenotype Chart — Stacked bar by gene and phenotype type
  • •Short Recommendation — Stacked bar by recommendation level
  • •Variant Classes — SNV, Insertion, Deletion
  • •Variant Impact — HIGH / MODERATE / LOW / MODIFIER
  • •SIFT / PolyPhen Classes — Functional prediction classes

API Access

A RESTful Application Programming Interface (API) has been developed to enable external systems to access Thai PGx Landscape platform data programmatically, without requiring use of the web interface. This API supports research, software development, and data analysis workflows. All API endpoints are accessible under the /api/v1/ path, support API key-based authentication, and use JSON as the data exchange format to ensure secure and convenient access.

API Coverage

The API structure encompasses the following core data types:

  • •Gene Data (Genes) — Retrieve all genes, access individual records, search, and pull summary and reference data
  • •Drug Data (Drugs) — Endpoints supporting diverse operations similar to gene data access
Gene Data API (Genes)

The gene API enables access to gene data in various formats according to user requirements, including retrieval of all records, access to specific individual records, search functionality, and extraction of specific data subsets.

Endpoint
GET /api/v1/genes
Parameters
page
limit
gene_card_summary
reference

Search Tips

Each module supports keyword-based search using terms such as gene names, drug names, or variant identifiers. In addition, filter options are available to refine results according to specific criteria, including variant type, phenotype classification, or population group.

Frequently Asked Questions

Troubleshooting

If difficulties are encountered while using the platform, the following guidance may assist in resolving common issues.

🔒
Unable to log in
Verify that the entered credentials are correct. If the issue persists, use the password reset function or contact the system administrator.
🔍
No search results returned
Confirm that the search term follows standardized nomenclature, such as HGNC gene symbols, INN drug names, or dbSNP identifiers. Verify that applied filters are not overly restrictive.
⏳
Slow system response
Check the stability of the internet connection. Refreshing the page or clearing the browser cache may resolve performance issues.
⚠️
Unexpected errors or display issues
Attempt to reload the page. If the problem persists across sessions or browsers, please report the issue to the system administrator.