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

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

Open
2 tasks done
asoskic opened this issue Nov 26, 2021 · 3 comments

Comments

@asoskic
Copy link

asoskic commented Nov 26, 2021

Title

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

Leaders

  • Anđela Šoškić, Twitter handle: @angelasoskic Mattermost handle: @asoskic
  • Remi Gau, Twitter handle: @RemiGau Mattermost handle: @RemiGau

Collaborators

NAMES AND TWITTER HANDLES:
Original team:

  • Anđela Šoškić, University of Belgrade @angelasoskic
  • Suzy Styles, Nanyang Technological University @suzyjstyles
  • Han Ke, Nanyang Technological University @hankepsy
  • Vanja Ković, University of Belgrade @VanjaKovic

INCF group members:

  • Remi Gau, Université catholique de Louvain @RemiGau
  • Alec Shaw, University of Zürich @alecsshaw
  • Ekansh Sareen, IIIT Delhi @ekanshsareen
  • Giorgio Ganis, University of Plymouth @giorgioganis
  • Guiomar Niso, Indiana University @GuiomarNiso
  • Jasmine Wei Rou Tan, Goldsmiths, University of London @jasminetan6032
  • Johannes Algermissen, Donders Institute, Radboud University,@johalgermissen
  • Matt Jaquiery, University of Oxford, @mjaquiery
  • Nastassja Lopes Fischer, Nanyang Technological University @nastalfischer
  • Robert Oostenveld, Donders Institute @oostenvr
  • Shamala Sundaray, Nanyang Technological University @ShamalaSundaray
  • Yu-Fang Yang, University of Würzburg @ufangYang
  • Yuri Pavlov, University of Tübingen, Ural Federal University @ugpavlov

BrainHack 2021 contributors:

  • Defu Yap, Nanyang Technological University
  • Fei Ting Woon, Nanyang Technological University @feitingW

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.

  • Add a comment below the main post of your issue saying: Hi @brainhackorg/project-monitors my project is ready!
  • Twitter-sized summary of your project pitch.
@asoskic
Copy link
Author

asoskic commented Nov 26, 2021

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

@jhlegarreta jhlegarreta added the bhg:melbourne_aus_1 BHG 2021 Australasia event label Nov 26, 2021
@Remi-Gau
Copy link
Member

@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
Copy link
Contributor

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

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment