SuperAPI AI Directory

scientific-human-protein-atlas

General & other

View repository

Updated 10-15 21:03

About this skill

Scientific Human Protein Atlas

Provides a tissue- and cell-level protein expression profiling pipeline utilizing the HPA REST API.

When to Use

  • When investigating tissue expression patterns of genes/proteins
  • When evaluating candidate cancer prognostic biomarkers
  • When checking subcellular localization
  • When comparing expression across cell lines
  • When integrating RNA expression data (HPA/GTEx/FANTOM5)

Quick Start

1. Retrieve HPA gene basic information

import requests
import pandas as pd

HPA_API = "https://www.proteinatlas.org/api"


def get_hpa_gene_info(ensembl_id):
    """
    HPA 遺伝子基本情報取得。

    Parameters:
        ensembl_id: str — Ensembl gene ID (e.g., "ENSG00000141510")

    ToolUniverse:
        HPA_get_gene_basic_info_by_ensembl_id(ensembl_id=ensembl_id)
        HPA_get_comprehensive_gene_details_by_ensembl_id(ensembl_id=ensembl_id)
    """
    url = f"https://www.proteinatlas.org/{ensembl_id}.json"
    resp = requests.get(url)
    resp.raise_for_status()
    data = resp.json()

    info = {
        "ensembl_id": ensembl_id,
        "gene_name": data.get("Gene", ""),
        "gene_description": data.get("Gene description", ""),
        "uniprot_id": data.get("Uniprot", []),
        "chromosome": data.get("Chromosome", ""),
        "protein_class": data.get("Protein class", []),
        "evidence": data.get("Evidence", ""),
    }

    print(f"HPA gene: {info['gene_name']} ({ensembl_id})")
    return info, data

2. Tissue RNA expression profile

def get_tissue_rna_expression(gene_name):
    """
    HPA 組織別 RNA 発現データ取得。

    ToolUniverse:
        HPA_get_rna_expression_by_source(gene=gene_name, source="HPA")
        HPA_get_rna_expression_in_specific_tissues(gene=gene_name, tissues=tissues)
    """
    url = f"https://www.proteinatlas.org/{gene_name}.json"
    resp = requests.get(url)
    resp.raise_for_status()
    data = resp.json()

    rna_data = data.get("RNA tissue specific nTPM", [])
    results = []
    for entry in rna_data:
        results.append({
            "tissue": entry.get("Tissue", ""),
            "cell_type": entry.get("Cell type", ""),
            "ntpm": float(entry.get("nTPM", 0)),
            "detection": entry.get("Detection", ""),
        })

    df = pd.DataFrame(results)
    if not df.empty:
        df = df.sort_values("ntpm", ascending=False)

    print(f"HPA RNA expression '{gene_name}': {len(df)} tissue entries")
    return df

3. Cancer prognostic biomarker analysis

def get_cancer_prognostics(gene_name):
    """
    HPA がん予後データ取得。

    ToolUniverse:
        HPA_get_cancer_prognostics_by_gene(gene=gene_name)
    """
    url = f"https://www.proteinatlas.org/{gene_name}.json"
    resp = requests.get(url)
    resp.raise_for_status()
    data = resp.json()

    prognostics = data.get("Pathology prognostics", [])
    results = []
    for entry in prognostics:
        results.append({
            "cancer_type": entry.get("Cancer type", ""),
            "prognostic_type": entry.get("Prognostic type", ""),
            "is_prognostic": entry.get("Is prognostic", False),
            "p_value": float(entry.get("p-value", 1.0)),
            "high_expression_favorable": entry.get(
                "High expression is favorable", None
            ),
        })

    df = pd.DataFrame(results)
    if not df.empty:
        df = df.sort_values("p_value")
        significant = df[df["p_value"] < 0.05]
        print(f"HPA cancer prognostics '{gene_name}': "
              f"{len(significant)}/{len(df)} significant")
    else:
        print(f"HPA cancer prognostics '{gene_name}': no data")
    return df

4. Subcellular localization

def get_subcellular_location(gene_name):
    """
    HPA 細胞内局在データ取得。

    ToolUniverse:
        HPA_get_subcellular_location(gene=gene_name)
    """
    url = f"https://www.proteinatlas.org/{gene_name}.json"
    resp = requests.get(url)
    resp.raise_for_status()
    data = resp.json()

    sc = data.get("Subcellular location", [])
    results = []
    for entry in sc:
        results.append({
            "location": entry.get("Location", ""),
            "reliability": entry.get("Reliability", ""),
            "enhanced": entry.get("Enhanced", False),
            "supported": entry.get("Supported", False),
            "cell_lines": entry.get("Cell lines", []),
        })

    df = pd.DataFrame(results)
    print(f"HPA subcellular '{gene_name}': {len(df)} locations")
    return df

5. Protein interaction network (HPA)

def get_hpa_protein_interactions(gene_name):
    """
    HPA タンパク質相互作用データ取得。

    ToolUniverse:
        HPA_get_protein_interactions_by_gene(gene=gene_name)
        HPA_get_biological_processes_by_gene(gene=gene_name)
        HPA_get_contextual_biological_process_analysis(gene=gene_name)
    """
    url = f"https://www.proteinatlas.org/{gene_name}.json"
    resp = requests.get(url)
    resp.raise_for_status()
    data = resp.json()

    interactions = data.get("Protein interaction partners", [])
    results = []
    for partner in interactions:
        results.append({
            "partner_gene": partner.get("Gene", ""),
            "partner_ensembl": partner.get("Ensembl", ""),
            "confidence": partner.get("Confidence", ""),
            "source": partner.get("Source", ""),
        })

    df = pd.DataFrame(results)
    print(f"HPA interactions '{gene_name}': {len(df)} partners")
    return df

References

Output Files

File Format
results/hpa_gene_info.json JSON
results/hpa_tissue_expression.csv CSV
results/hpa_cancer_prognostics.csv CSV
results/hpa_subcellular.csv CSV
results/hpa_interactions.csv CSV

Available tools

Category Main tools Purpose
HPA HPA_generic_search General search
HPA HPA_get_gene_basic_info_by_ensembl_id Gene basic information
HPA HPA_get_comprehensive_gene_details_by_ensembl_id Comprehensive details
HPA HPA_get_rna_expression_by_source RNA expression
HPA HPA_get_rna_expression_in_specific_tissues Tissue-specific expression
HPA HPA_get_cancer_prognostics_by_gene Cancer prognosis
HPA HPA_get_subcellular_location Subcellular localization
HPA HPA_get_protein_interactions_by_gene PPI
HPA HPA_get_biological_processes_by_gene Biological processes
HPA HPA_get_contextual_biological_process_analysis Process analysis
HPA HPA_get_disease_expression_by_gene_tissue_disease Disease expression
HPA HPA_get_comparative_expression_by_gene_and_cellline Cell line comparison
HPA HPA_get_gene_tsv_data_by_ensembl_id TSV Data
HPA HPA_search_genes_by_query Gene search

Reference skills

Skills Related
scientific-gene-expression-transcriptomics GEO/GTEx expression analysis
scientific-proteomics-mass-spectrometry Proteomics
scientific-cancer-genomics Cancer Genomics
scientific-protein-interaction-network PPI Network
scientific-pathway-enrichment Pathway enrichment

Dependencies

requests, pandas