{"id":21390,"library":"goatools","title":"GOATOOLS","description":"A Python library to find enrichment of Gene Ontology (GO) terms among a set of genes. It provides tools for GO term enrichment analysis (Fisher's exact test, GOEA), GO term association, and visualization of GO hierarchies. Current version 1.6.4, released June 2024. Regular updates every few months.","status":"active","version":"1.6.4","language":"python","source_language":"en","source_url":"https://github.com/tanghaibao/goatools","tags":["bioinformatics","gene ontology","enrichment analysis","GOEA","GO-term"],"install":[{"cmd":"pip install goatools","lang":"bash","label":"Install via pip"}],"dependencies":[{"reason":"Data manipulation for gene lists and results","package":"pandas","optional":false},{"reason":"Numerical computations","package":"numpy","optional":false},{"reason":"Statistical tests (Fisher's exact test)","package":"scipy","optional":false}],"imports":[{"wrong":"from goatools import GOEnrichmentStudy","symbol":"GOEnrichmentStudy","correct":"from goatools.goea.go_enrichment_ns import GOEnrichmentStudy"}],"quickstart":{"code":"from goatools import GOEnrichmentStudy\nfrom goatools.obo_parser import GODag\nfrom goatools.associations import read_associations\n\n# Download go-basic.obo from http://geneontology.org/ontology/go-basic.obo\nobodag = GODag('go-basic.obo')\n\n# Load gene-to-GO associations (tab-separated: gene_id\\tGO_id)\nassoc = read_associations('gene2go.tsv', obodag, no_top=True)\n\n# List of gene IDs of interest (e.g., from RNA-seq)\ngene_list = ['GENE1', 'GENE2', 'GENE3']\n\n# Background population (e.g., all genes in genome)\npopulation = list(assoc.keys())\n\n# Run enrichment\ngoea = GOEnrichmentStudy(population, assoc, obodag, propagate_count=True, alpha=0.05)\nresults = goea.run_study(gene_list)\n\nprint(results[:5])","lang":"python","description":"Basic workflow: load GO DAG, load associations, run enrichment study."},"warnings":[{"fix":"Download go-basic.obo from http://geneontology.org/ontology/go-basic.obo and pass local path.","message":"The `GODag` expects a local OBO file. Many users forget to download go-basic.obo first. Use `goatools.obo_parser.GODag('http://purl.obolibrary.org/obo/go/go-basic.obo')` to fetch remotely only if you have stable internet; but for reproducibility, download locally.","severity":"gotcha","affected_versions":"all"},{"fix":"Ensure exactly two columns: gene_symbol\\tGO:0000000.","message":"The `associations` file must be tab-separated with two columns: gene_id and GO_id. Extra columns or non-tab separators cause silent errors.","severity":"gotcha","affected_versions":"all"},{"fix":"Use `from goatools.associations import read_associations`.","message":"The function `goatools.evidence._evidence_filter` was removed in v1.0. Use `goatools.associations` instead.","severity":"deprecated","affected_versions":">=1.0"},{"fix":"Set `propagate_count=True` in GOEnrichmentStudy constructor.","message":"Enrichment results may have many rows with the same p-value due to propagation. Use `propagate_count=True` to avoid spurious significance.","severity":"gotcha","affected_versions":"all"}],"env_vars":null,"search_vec":"'1.6.4':41 '2024':44 'among':13 'analysi':25,54 'associ':33 'bioinformat':50 'current':39 'enrich':7,24,53 'everi':47 'exact':28 'find':6 'fisher':26 'gene':9,17,51 'go':11,22,31,37,57 'go-term':56 'goatool':1 'goea':30,55 'hierarchi':38 'june':43 'librari':4 'month':49 'ontolog':10,52 'provid':19 'python':3 'regular':45 'releas':42 'set':15 'term':12,23,32,58 'test':29 'tool':20 'updat':46 'version':40 'visual':35","created_at":"2026-04-27T16:59:38.853992+00:00","updated_at":"2026-04-27T16:59:38.853992+00:00","problems":null,"ecosystem":"pypi","meta_description":null,"install_score":null,"quickstart_score":null,"quickstart_tag":null,"pypi_latest":"1.6.5","cli_name":"","cli_version":null,"type":"library","homepage":null,"github":"http://github.com/tanghaibao/goatools","docs":null,"changelog":null,"pypi":"https://pypi.org/project/goatools/","npm":null,"openapi_spec":null,"status_page":null,"smithery":null,"categories":["data","ai-ml"],"base_url":null,"auth_type":null,"provenance":{"verified_status":"passing","verified_at":"2026-07-03","last_verified":"2026-07-03","next_check":"2026-08-02","install_tag":null}}