Merge remote-tracking branch 'upstream/main' into rename

* upstream/main:
  MNT: BackgroundPlotter has no attribute named image (mne-tools#9318)
  [MRG, DOC] Remove CSD average reference note (mne-tools#9320)

Author: larsoner

examples/simulation/simulate_evoked_data.py

@@ -22,7 +22,7 @@
 print(__doc__)
 
 ###############################################################################
-# Load real data as templates
+# Load real data as templates:
 data_path = sample.data_path()
 
 raw = mne.io.read_raw_fif(data_path + '/MEG/sample/sample_audvis_raw.fif')

mne/preprocessing/_csd.py

@@ -83,9 +83,6 @@ def compute_current_source_density(inst, sphere='auto', lambda2=1e-5,
 
     Notes
     -----
-    This function applies an average reference to the data if copy is False.
-    Do not transform CSD data to source space.
-
     .. versionadded:: 0.20
 
     References
@@ -98,6 +95,7 @@ def compute_current_source_density(inst, sphere='auto', lambda2=1e-5,
     if inst.info['custom_ref_applied'] == FIFF.FIFFV_MNE_CUSTOM_REF_CSD:
         raise ValueError('CSD already applied, should not be reapplied')
 
+    _validate_type(copy, (bool), 'copy')
     inst = inst.copy() if copy else inst
 
     picks = pick_types(inst.info, meg=False, eeg=True, exclude=[])
@@ -143,8 +141,6 @@ def compute_current_source_density(inst, sphere='auto', lambda2=1e-5,
         raise ValueError('sphere radius must be greater than 0, '
                          'got %s' % radius)
 
-    _validate_type(copy, (bool), 'copy')
-
     pos = np.array([inst.info['chs'][pick]['loc'][:3] for pick in picks])
     if not np.isfinite(pos).all() or np.isclose(pos, 0.).all(1).any():
         raise ValueError('Zero or infinite position found in chs')

mne/viz/backends/_qt.py

@@ -507,6 +507,8 @@ def show(self):
             with self._window_ensure_minimum_sizes():
                 self.plotter.app_window.show()
         self._update()
+        for plotter in self._all_plotters:
+            plotter._render()
         self._process_events()
 
 

tutorials/forward/20_source_alignment.py

@@ -268,7 +268,7 @@ def add_head(renderer, points, color, opacity=0.95):
 # images. Here's what that would look like (we'll use the nasion landmark as a
 # representative example):
 
-# Get the nasion
+# Get the nasion:
 nasion = [p for p in raw.info['dig'] if
           p['kind'] == FIFF.FIFFV_POINT_CARDINAL and
           p['ident'] == FIFF.FIFFV_POINT_NASION][0]

tutorials/inverse/90_phantom_4DBTi.py

@@ -64,7 +64,7 @@
 print("errors (mm) : %s" % errors)
 
 ###############################################################################
-# Plot the dipoles in 3D:
+# Plot the dipoles in 3D
 actual_amp = np.ones(len(dip))  # misc amp to create Dipole instance
 actual_gof = np.ones(len(dip))  # misc GOF to create Dipole instance
 dip = mne.Dipole(dip.times, pos, actual_amp, ori, actual_gof)