'Get a SourceEstimate object restricted to a label.
SourceEstimate contains the time course of
activation of all sources inside the label.
Parameters
label : Label | BiHemiLabel
The label (as created for example by mne.read_label). If the label
does not match any sources in the SourceEstimate, a ValueError is
raised.'

def in_label(self, label):

    if ((label.subject is not None) and (self.subject is not None) and (label.subject != self.subject)):
        raise RuntimeError(('label    and    stc    must    have    same    subject    names,    currently    "%s"    and    "%s"' % (label.subject, self.subject)))
    if (label.hemi == 'both'):
        (lh_vert, lh_val) = self._hemilabel_stc(label.lh)
        (rh_vert, rh_val) = self._hemilabel_stc(label.rh)
        vertices = [lh_vert, rh_vert]
        values = np.vstack((lh_val, rh_val))
    elif (label.hemi == 'lh'):
        (lh_vert, values) = self._hemilabel_stc(label)
        vertices = [lh_vert, np.array([], int)]
    elif (label.hemi == 'rh'):
        (rh_vert, values) = self._hemilabel_stc(label)
        vertices = [np.array([], int), rh_vert]
    else:
        raise TypeError(('Expected        Label    or    BiHemiLabel;    got    %r' % label))
    if (sum([len(v) for v in vertices]) == 0):
        raise ValueError('No    vertices    match    the    label    in    the    stc    file')
    label_stc = SourceEstimate(values, vertices=vertices, tmin=self.tmin, tstep=self.tstep, subject=self.subject)
    return label_stc
