Skip to content

Improve consistency of sensor types in code and documentation#12509

Merged
larsoner merged 29 commits intomne-tools:mainfrom
nabilalibou:alibou_data_type
Mar 29, 2024
Merged

Improve consistency of sensor types in code and documentation#12509
larsoner merged 29 commits intomne-tools:mainfrom
nabilalibou:alibou_data_type

Conversation

@nabilalibou
Copy link
Copy Markdown
Contributor

@nabilalibou nabilalibou commented Mar 20, 2024

Aim to resolve this issue #12490 about improving the glossary for sensor types and add some referencement in some part of the documentation (docstrings, tutorial) but during the processing of this issue we found inconsistencies with @larsoner in the dictionaries containing the sensor type constants.

The objective is to adress these inconsistencies bit by bit, while keeping an eye on what breaks.

@nabilalibou nabilalibou marked this pull request as draft March 20, 2024 13:40
nabilalibou and others added 18 commits March 20, 2024 16:50
- ADD missing types from 'get_channel_type_constants()' to 'get_data_channels()' docstring.
- Replaced eyetrack_pos, eyetrack_pupil by eyegaze and pupil respectively to eb coherent with 'get_channel_type_constants()'.
- Change the list to be in alphabetical order
- Add a reference link to sensor types in glossary

In the same way, add missing types and reference link in 'raw overview' tutorial.
…yed corresponds only to the main category (_first_rule)
…ta_type

# Conflicts:
#	doc/sphinxext/mne_substitutions.py
FIX "non-data channels" part of mne_substitutions.py
…and scalings dict from defaults.py

FIX docstring bullet list of create_info()
@nabilalibou nabilalibou marked this pull request as ready for review March 27, 2024 16:40
@nabilalibou
Copy link
Copy Markdown
Contributor Author

nabilalibou commented Mar 27, 2024

I did not manage to make a bullet point list with one line running over 2 lines without making the 2nd line bold => https://output.circle-artifacts.com/output/job/e5526822-766b-4d68-84a0-364d3d61fe7f/artifacts/0/html/generated/mne.create_info.html

edit: It seems that putting 'ready for review' removes the assigned reviewers, so I'm making a manual tag just in case, @larsoner, @drammock @agramfort @dengemann

Copy link
Copy Markdown
Member

@larsoner larsoner left a comment

Choose a reason for hiding this comment

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

Otherwise looks good to me!

@larsoner
Copy link
Copy Markdown
Member

Also don't forget a changelog entry. I think it could go in the category other

@larsoner
Copy link
Copy Markdown
Member

Failures are unrelated and are being fixed in #12520, thanks @nabilalibou !

@larsoner larsoner merged commit c4d20c3 into mne-tools:main Mar 29, 2024
larsoner added a commit to larsoner/mne-python that referenced this pull request Mar 29, 2024
* upstream/main:
  Improve consistency of sensor types in code and documentation (mne-tools#12509)
@nabilalibou nabilalibou deleted the alibou_data_type branch March 29, 2024 15:35
larsoner added a commit to larsoner/mne-python that referenced this pull request Apr 15, 2024
* upstream/main: (50 commits)
  ENH: Improve OPM auditory dataset and example (mne-tools#12539)
  MAINT: Bump to latest pydata-sphinx-theme (mne-tools#12228)
  MRG: Simplify manual installation instructions a little by dropping explicit mention of (lib)mamba (mne-tools#12362)
  fix PSD weights handling when bad annotations present (mne-tools#12538)
  Fix phase loading (mne-tools#12537)
  align FFT windows to good data spans in psd_array_welch (mne-tools#12536)
  explicitly disallow multitaper in presence of bad annotations (mne-tools#12535)
  MAINT: Clean up PyVista contexts (mne-tools#12533)
  MAINT: Complete API change of ordered (mne-tools#12534)
  MAINT: Reinstall statsmodels and improve logging (mne-tools#12532)
  MAINT: Remove scipy.signal.morlet2 (mne-tools#12531)
  Update README badge links (mne-tools#12529)
  BUG: Fix bug with reading his_id from snirf (mne-tools#12526)
  [pre-commit.ci] pre-commit autoupdate (mne-tools#12524)
  Fix file format check in _check_eeglab_fname function (mne-tools#12523)
  MAINT: Reenable picard in pre testing (mne-tools#12525)
  MAINT: Bump to large resource class (mne-tools#12522)
  MAINT: Restore 2 jobs on Windows (mne-tools#12520)
  Add exclude_after_unique option to mne.io.read_raw_edf/read_raw_edf to search for exclude channels after making channel names unique (mne-tools#12518)
  Improve consistency of sensor types in code and documentation (mne-tools#12509)
  ...
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.

3 participants