Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

[FIX]: Hierarchical Event Descriptors (HED) page update #1592

Closed
wants to merge 19 commits into from

Conversation

tpatpa
Copy link
Contributor

@tpatpa tpatpa commented Aug 23, 2023

Update the HED specification page with respect to the latest HED developments, including HED-SCORE example, partnered library schemas, and HED standard schema version 8.2.0.

tpatpa and others added 2 commits August 23, 2023 11:29
Update the HED specification page with respect to the latest HED developments, including HED-SCORE example, partnered library schemas and HED standard schema version 8.2.0.
@codecov
Copy link

codecov bot commented Aug 23, 2023

Codecov Report

All modified lines are covered by tests ✅

Comparison is base (f9cfafa) 87.83% compared to head (5208fb2) 87.83%.

Additional details and impacted files
@@           Coverage Diff           @@
##           master    #1592   +/-   ##
=======================================
  Coverage   87.83%   87.83%           
=======================================
  Files          16       16           
  Lines        1356     1356           
=======================================
  Hits         1191     1191           
  Misses        165      165           

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

src/appendices/hed.md Outdated Show resolved Hide resolved
Correct for proper use of semantic line breaks.
src/appendices/hed.md Show resolved Hide resolved
src/appendices/hed.md Show resolved Hide resolved
@@ -130,23 +179,42 @@ This allows for a proper validation of the HED annotations (for example using th
}
```

If you omit the `HEDVersion` field from the dataset description file, a warning will be generated and any present HED information will be validated using the latest version of the HED schema.
This is bound to result in problems, and hence, it is strongly RECOMMENDED that the `HEDVersion` field be included when using HED in a BIDS dataset.
If you omit the `HEDVersion` field from the dataset description file,
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I think this is not correct. I believe the current versions of the hed-validator require a HedVersion if HED is in the dataset. I will verify and get back to you @happy5214 can you comment?

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I checked with @happy5214. If your dataset has HED in it and you don't have a HEDVersion field in your dataset_description.json, an error is generated rather than making an assumption about version.

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

[email protected] doesn't seem to be validating HED and the hed-examples Jupyter notebook seems to be validating against the latest version of the HED schema in case the HEDVersion field is omitted.
What version should I check this against?

src/appendices/hed.md Outdated Show resolved Hide resolved
src/appendices/hed.md Show resolved Hide resolved
src/appendices/hed.md Outdated Show resolved Hide resolved
src/appendices/hed.md Outdated Show resolved Hide resolved
src/appendices/hed.md Outdated Show resolved Hide resolved
src/appendices/hed.md Outdated Show resolved Hide resolved
tpatpa added 6 commits August 30, 2023 14:27
Corrected typos.
Removed 'version' per PR review.
Corrected typos.
When referring to the column name, ‘duration’ is used, and when referring to the HED tag, ‘Duration’ is used.
Correcting standard schema example (validated with https://hedtools.org/hed/string)
Updated `HEDVersion` field use statement
Copy link
Member

@VisLab VisLab left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

See correction.

src/appendices/hed.md Outdated Show resolved Hide resolved
Corrected red/blue square to match across the `events.tsv` file, accompanying `events.json` sidecar, and fully assembled annotation.
`HEDVersion` field clarification
@tpatpa
Copy link
Contributor Author

tpatpa commented Sep 1, 2023

Thank you @VisLab !
Correction to the standard schema example and HEDVersion field clarification were made.

@dorahermes
Copy link
Member

@VisLab which of the 3 examples is the most recent/common/recommended example? (1: Unpartnered library schema example, 2: Single unpartnered library schema example and 3: Partnered library schema). If example 3 is most common, that should probably be the first instead.

Change per review.
src/appendices/hed.md Outdated Show resolved Hide resolved
@christinerogers
Copy link
Contributor

nice to see these updates.
cc EEGnet team @Andesha @jeffersoncasimir

effigies
effigies previously approved these changes Sep 7, 2023
Copy link
Collaborator

@effigies effigies left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Overall LGTM. Small style suggestions.

src/appendices/hed.md Outdated Show resolved Hide resolved
src/appendices/hed.md Outdated Show resolved Hide resolved
@sappelhoff sappelhoff changed the base branch from master to bep011 September 8, 2023 07:51
@sappelhoff sappelhoff changed the base branch from bep011 to master September 8, 2023 07:51
tpatpa and others added 5 commits September 11, 2023 11:42
Fix alignment

Co-authored-by: Chris Markiewicz <[email protected]>
Cleaner line breaks and adding back-ticks.

Co-authored-by: Chris Markiewicz <[email protected]>
Corrected 'schemas' to 'schema'
minor grammar edits
@effigies effigies dismissed their stale review September 29, 2023 13:02

Merge conflicts polluting branch. See #1623 instead.

@VisLab
Copy link
Member

VisLab commented Oct 1, 2023

Do I need to address anything here? Thx

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

5 participants