{"id":35236582,"url":"https://github.com/hed-standard/hed-matlab","last_synced_at":"2026-01-20T17:10:06.538Z","repository":{"id":219788575,"uuid":"745544166","full_name":"hed-standard/hed-matlab","owner":"hed-standard","description":"HED MATLAB supporting tools","archived":false,"fork":false,"pushed_at":"2026-01-06T12:36:04.000Z","size":788,"stargazers_count":1,"open_issues_count":2,"forks_count":4,"subscribers_count":2,"default_branch":"main","last_synced_at":"2026-01-08T02:51:32.985Z","etag":null,"topics":["annotation","behavior","eeg","events","experiments","fmri","matlab","neuroimaging"],"latest_commit_sha":null,"homepage":"https://www.hedtags.org/hed-matlab","language":"MATLAB","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/hed-standard.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","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":"2024-01-19T15:10:17.000Z","updated_at":"2026-01-06T12:36:02.000Z","dependencies_parsed_at":"2024-04-19T23:26:48.618Z","dependency_job_id":"de8a1fc2-7fd8-4274-a317-3c1aa9b4bdf5","html_url":"https://github.com/hed-standard/hed-matlab","commit_stats":null,"previous_names":["hed-standard/hed-matlab"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/hed-standard/hed-matlab","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hed-standard%2Fhed-matlab","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hed-standard%2Fhed-matlab/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hed-standard%2Fhed-matlab/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hed-standard%2Fhed-matlab/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/hed-standard","download_url":"https://codeload.github.com/hed-standard/hed-matlab/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hed-standard%2Fhed-matlab/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28607624,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-20T16:10:39.856Z","status":"ssl_error","status_checked_at":"2026-01-20T16:10:39.493Z","response_time":117,"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":["annotation","behavior","eeg","events","experiments","fmri","matlab","neuroimaging"],"created_at":"2025-12-30T04:02:38.414Z","updated_at":"2026-01-20T17:10:06.514Z","avatar_url":"https://github.com/hed-standard.png","language":"MATLAB","funding_links":[],"categories":[],"sub_categories":[],"readme":"[![Documentation Status](https://readthedocs.org/projects/hed-matlab/badge/?version=latest)](https://www.hed-matlab.org/en/latest/?badge=latest) [![DOI](https://zenodo.org/badge/DOI/10.5281/zenodo.13201056.svg)](https://doi.org/10.5281/zenodo.13201056)\n\n# HED-MATLAB\n\nThis repository contains the MATLAB supporting code infrastructure for Hierarchical Event Descriptors (HED). HED is an ecosystem that includes standardized vocabularies and tools for annotating what happened during an experiment. HED is used for human behaviorial and neuroimaging experiments. See the [**HED Homepage**](https://www.hedtags.org) for more information.\n\nThe documentation for `hed-matlab` can be found at [**MATLAB HEDTools**](https://www.hed-resources.org/en/latest/HedMatlabTools.html).\n\n## Two ways of using HED\n\nThe `hed-matlab` MATLAB library provides two approaches for using the HED toolbase: 1) through webservices and 2) through MATLAB calls to the HED Python tools. These approaches provide identical interfaces and are accessed through MATLAB using the same method calls.\n\n### Approach 1: HED web services\n\nIn this approach, the HEDTools are accessed through MATLAB wrapper functions that package the function parameters, call the HED web services, retrieve the result, and transform back to suitable MATLAB values.\n\n**Advantages:** No extra installation.\n\n**Disadvantages:** Requires access to Internet.\n\n### Approach 2: HEDTools Python calls\n\nIn this approach, the HEDTools are accessed through MATLAB wrapper functions that package function parameters and call the Python `HedTools` directly from MATLAB lab.\n\n**Advantages:** No Internet access needed. Some additional functionality not in the `hed-matlab` interface is provided.\n\n**Disadvantages:** Installation of Python in MATLAB can be tricky and requires MATLAB version \u003e= 2022b.\n\n## Usage\n\nTo use HED tools, you first create a HED object by calling `getHedTools`. If you provide the optional host argument, the HED tools use services, otherwise direct calls to Python. Once created, you simply call the available methods using that reference. The process is summarized in the following diagram.\n\n![Matlab HED Tools](https://www.hed-resources.org/en/latest/_images/MatLabHedToolsCloseFit.png)\n\nThe MATLAB HedTools accept a variety of different types of MATLAB variables as input and convert as appropriate for the underlying calls. On return, the tools convert back to MATLAB types.\n\n## Basic installation\n\nTo use the HED tools for MATLAB you need to download the tools either by downloading from GitHub or from MATHWorks File Exchange.\n\nGo to the directory that you want to download the library into. If you are using Git, clone the [**hed-matlab**](https://github.com/hed-standard/hed-matlab) repository.\n\n```shell\ngit clone https://github.com/hed-standard/hed-matlab.git\n```\n\nYou can also download the latest release as a zip file from the [**hed-matlab releases**](https://github.com/hed-standard/hed-matlab/releases) tab on GitHub.\n\nOnce you have download and unzipped if necessary, you have to add the path of the `hedmat` subdirectory of `hed-matlab` to your workspace:\n\n```matlab\n\u003e myPath = 'xxx';  # This should be the full path to hedmat\n\u003e addpath(addpath(genpath(myPath));\n```\n\n### Additional steps for Python\n\nThe Python approach requires you to install Python, install the Python HedTools, and link to MATLAB. See [**Matlab Python Install**](https://www.hed-resources.org/en/latest/HedMatlabTools.html#matlab-python-install) for detailed instructions.\n\n## Funding\n\nPartial support for this project was provided by [**NIH 1R01MH126700-01A1**](https://reporter.nih.gov/project-details/10480619).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhed-standard%2Fhed-matlab","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fhed-standard%2Fhed-matlab","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhed-standard%2Fhed-matlab/lists"}