{"id":34110332,"url":"https://github.com/bojarlab/glycogym","last_synced_at":"2026-04-02T01:01:23.340Z","repository":{"id":320104138,"uuid":"1076924790","full_name":"BojarLab/GlycoGym","owner":"BojarLab","description":null,"archived":false,"fork":false,"pushed_at":"2025-11-18T14:55:55.000Z","size":787,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-12-17T02:43:03.018Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/BojarLab.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-10-15T14:29:18.000Z","updated_at":"2025-11-18T14:55:58.000Z","dependencies_parsed_at":"2025-10-22T01:16:26.896Z","dependency_job_id":"63fd5b2b-a77f-42c8-b18f-1d21abcefc94","html_url":"https://github.com/BojarLab/GlycoGym","commit_stats":null,"previous_names":["bojarlab/glycogym"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/BojarLab/GlycoGym","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/BojarLab%2FGlycoGym","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/BojarLab%2FGlycoGym/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/BojarLab%2FGlycoGym/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/BojarLab%2FGlycoGym/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/BojarLab","download_url":"https://codeload.github.com/BojarLab/GlycoGym/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/BojarLab%2FGlycoGym/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31293631,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-01T21:15:39.731Z","status":"ssl_error","status_checked_at":"2026-04-01T21:15:34.046Z","response_time":53,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2025-12-14T18:51:15.294Z","updated_at":"2026-04-02T01:01:23.304Z","avatar_url":"https://github.com/BojarLab.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cp align=\"center\"\u003e\n  \u003cimg src=\"/docs/imgs/glycogym_banner.svg\" style=\"height:100%;width:100%;\"\u003e\n\u003c/p\u003e\n\n[![DOI](https://zenodo.org/badge/DOI/10.5281/zenodo.17313055.svg)](https://doi.org/10.5281/zenodo.17313055)\n![testing](https://github.com/bojarlab/glycogym/actions/workflows/test.yaml/badge.svg)\n\nGlycan property prediction is an increasingly popular area of machine learning research. Supervised learning approaches have shown promise in glycan modeling; however, the current literature is fragmented regarding datasets and standardized evaluation techniques, hampering progress in understanding these complex, branched carbohydrates that play crucial roles in biological processes. To facilitate progress, we introduce GlycoGym, a comprehensive benchmark suite containing six biologically relevant supervised learning tasks spanning different domains of glycobiology: glycosylation linkage identification, tissue expression prediction, taxonomy classification, tandem mass spectrometry fragmentation prediction, lectin-glycan interaction modeling, and structural property estimation. We curate tasks into specific training, validation, and test splits using multi-class stratification to ensure that each task tests biologically relevant generalization that transfers to real-life glycan property prediction scenarios. GlycoGym will help the machine learning community to focus their efforts on scientifically relevant glycan prediction problems.\n\n## Installation\n\nYou can install GlycoGym via pip:\n\n```bash\npip install glycogym\n```\n\n## Usage\n\nThe main intention of this package is to build the benchmark for the upload to Zenodo, everytime the datasets with `glycowork` or `GlyContact` get significantly updated.\n\nBut one can also use it to build local versions of the benchmark during the update cycles of the Zenodo repository.\n\n```python\nfrom glycogym import build_glycosylation, build_taxonomy, build_tissue, build_lgi\n\ndf, mapping = build_glycosylation()\ndf_taxonomy = build_taxonomy(\"Kingdom\")\ndf_tissue = build_tissue()\ndf_r, df_cl, df_cg = build_lgi()\n```\n\n### Tandem Mass Spectrometry Fragmentation Prediction\n\nOne special dataset is the MS fragmentation prediction dataset, which can be built as follows:\n\n```python\nfrom glycogym import build_spectrum\n\ndf_ms = build_spectrum(root=\"path/to/folder/with/pkl/files\")\n```\n\nHere, the root argument defined the path to the folder containing the `.pkl` files comprising the MS fragmentation prediction dataset by CandyCrunch, which can be downloaded from [here](https://zenodo.org/record/7940047).\n\n### Structural Property Estimation\n\nThe second dataset that requires special handling is the structural property estimation dataset. Currently, it needs to be build from the GlyContact package. That can be installed with the following command:\n\n```bash\npip install -e git+https://github.com/lthomes/glycontact.git#egg=glycontact[ml]\n```\n\nThen, the dataset can be built as follows:\n\n```python\nfrom glycontact.learning import create_dataset\n\ntrain, val, test = create_dataset(splits=[0.7, 0.2, 0.1])\n```\n\n## Zenodo\n\nThe latest version of the GlycoGym benchmark can be found on Zenodo: https://doi.org/10.5281/zenodo.17313055\n\n## Citation\n\ntbd\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbojarlab%2Fglycogym","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbojarlab%2Fglycogym","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbojarlab%2Fglycogym/lists"}