brainhackorg / global2021

Website for Brainhack global 2021
https://brainhack.org/global2021/
MIT License
3 stars 11 forks source link

Agreed Reporting Template for EEG Methodology - International Standard (ARTEM-IS): web-app and terminology lexicon #153

Open asoskic opened 2 years ago

asoskic commented 2 years ago

Title

Agreed Reporting Template for EEG Methodology - International Standard (ARTEM-IS): web-app and terminology lexicon

Leaders

Collaborators

NAMES AND TWITTER HANDLES: Original team:

INCF group members:

BrainHack 2021 contributors:

Brainhack Global 2021 Event

Brainhack Australasia

Project Description

In the EEG 'Garden of Forking Paths,' most research reports do not have enough detail to know which path has been taken, hampering reproducibility, replication and meta-science (Šoškić et al., 2021).

ARTEM-IS is an INCF initiative (https://www.incf.org/sig/incf-working-group-artem) to create community-developed, Agreed Reporting Templates that are designed to make reporting EEG methodology easier and FAIR-compliant (findability, accessibility, interoperability, and reusability: https://www.go-fair.org/fair-principles/), by asking you all the right questions about EEG methodological details and allowing you to download your responses as a supplement to your publication or preregistration (ARTEM-IS https://doi.org/10.17605/OSF.IO/PDX6Y).

ARTEM-IS ensures that all the right questions are asked by following ARTEM-IS Design Guidelines, which draw from the experience of other industries that implement checklists and templates, such as surgery or aviation, as we all by utilizing knowledge of typical reporting errors obtained by systematic reviews of existing publications (Styles, et al., 2021: https://doi.org/10.1016/j.neuroimage.2021.118721).

As the first ARTEM-IS Template, we are currently developing a reporting tool for ERP methods, in the form of a web-app based on eCOBIDAS model. We already have a working demo of this app, and you can try it here.

Join us in the Hack to make the tools we need!

Link to project repository/sources

Link to project repository/sources Current and previous versions of static docs can be found on the ARTEM-IS OSF: https://osf.io/nrh2k/ Editable doc links will be shared directly on Mattermost and in the ARTEM-IS Clubroom in Gathertown.

Goals for Brainhack Global

For this hackathon, we will be working on two fronts.

First goal is to fix some of the existing bugs in the web-app template: list of issues.

We will also be working on creating the body of terms for the future EEG terminology lexicon of terms present in ARTEM-IS Templates (currently ARTEM-IS Template for ERP). This lexicon will eventually accompany templates as part of help and documentation. During this hackathon, we will work on:

  1. identifying terms that are present in the current ARTEM-IS template, and not on the list of terms that will be included in the ARTEM-IS lexicon;
  2. identifying terms that exist in the following lexicons of terminology: NIDM communities (i.e. NIDM Terms, NIDM Concepts, BIDS Specification, CONP DATS, Neurobridge), InterLex and COBIDAS;
  3. adding proposals for definitions for terms that are not defined.

Good first issues

  1. web-app: Using our documentation you can run the app on your computer and make live changes to the questions displayed by the app.
  2. lexicon: identifying terms that are present in the current ARTEM-IS template, and not on the list of terms that will be included in the ARTEM-IS lexicon

Communication channels

Mattermost: https://mattermost.brainhack.org/brainhack/channels/artem-is ARTEM-IS Gathertown Clubroom: https://gather.town/app/Bw3fcD2KiO11izhe/artemisclubroom (Password on Mattermost)

daily check in in the Clubroom: 8 AM CET (3 PM SGT, 6 PM AEDT)

Skills

For the goal of fixing bugs, basic spreadsheet experience, as well as programming skills (in particular javascript and Vue.js) are both welcome! More experienced coders can take part in debugging, but newbies to programming can also be very helpful with troubleshooting. Experience conducting EEG or describing EEG methods would be a bonus, but not necessary to participate.

To work on the lexicon, knowledge about EEG methodology and terminology will be essential, but no programming skills at all are expected.

Onboarding documentation

Will be made available via Mattermost and permanently stored on the OSF project.

What will participants learn?

Participants will be part of an open science collaborative project. They will become familiar with electrophysiology and different resources and initiatives to standardize and report neuroimaging data and analysis methodology. Particularly, they will get insights into the metascience of EEG, and improve their understanding of EEG methodology, and best practice in documenting and reporting it.

Participants who will take part in the app improvement, either by helping programmers troubleshoot issues or by working on these issues themselves, will get an opportunity to practice programming skills and exchange knowledge with others. Participants will also have an opportunity to work on an example of Reproschema standardized form generation schema (A standardized form generation and data collection schema).

Participants who work on the EEG terminology lexicon will get an opportunity to work on the development of a lexicon of EEG terms, as well as to get insights into existing lexicons of neuroscience terminology and the process of building a new lexicon and integrating it into the community of other lexicons.

Data to use

No response

Number of collaborators

more

Credit to collaborators

Contributors in this hackathon will be acknowledged on a contributors page in the ARTEM-IS OSF Project (https://osf.io/ut9pc/ and https://osf.io/nrh2k/contributors).

Image

artemis logo

Type

coding_methods, documentation, other

Development status

1_basic structure

Topic

EEG_EventRelatedResponseModelling, reproducible_scientific_methods

Tools

other

Programming language

documentation, other, not_applicable

Modalities

EEG

Git skills

0_no_git_skills, 1_commit_push, 2_branches_PRs, 3_continuous_integration

Anything else?

Programming language: JavaScript

Things to do after the project is submitted and ready to review.

asoskic commented 2 years ago

Hi @brainhackorg/project-monitors my project is ready!

Remi-Gau commented 2 years ago

@likeajumprope Can I ask you to review this one?

The fact that I am on this project is a bit of conflict of interest to make me a good reviewer.

likeajumprope commented 2 years ago

Looks great! I especially like the "Collaborator: more" part :)