Verbs that act on views as objects:
Arguments
- atlas
A
ggseg_atlasobject- views
View names to act on. Matched whole and case-insensitively against the atlas's own views, so a name has to be one
atlas_views()reports. Give them as a character vector, or in one string separated by"|"; the two are equivalent. Names that match no view are warned about and otherwise ignored.- match
How
viewsis read."exact", the default, takes each name as a whole view name."pattern"takesviewsas a regular expression instead, matched as a substring —"axial"then reachesaxial_1andaxial_2as well. Prefer"exact": a name that happens to sit inside another view's name silently takes both views with it under"pattern".- gap
Proportional gap between views (default 0.15 = 15% of max width).
- order
For
atlas_view_reorder(): character vector of desired view order. Unspecified views appended at end.
Details
atlas_view_remove(): remove entire viewsatlas_view_keep(): keep only matching viewsatlas_view_reorder(): change view orderatlas_view_gather(): reposition views to close gaps
None of these changes what is drawn inside a view. For that — dropping a region's depiction in some views while the region itself stays — see drawing_manipulation.
Functions
atlas_view_keep(): Keep only views matching pattern. Remaining views are re-packed viaatlas_view_gather()so the layout stays tight, asatlas_view_remove()does.atlas_view_gather(): Reposition remaining views to close gaps after view removal.atlas_view_reorder(): Reorder views and reposition. Views not inorderare appended at end.
See also
atlas_manipulation for the other groups
Other atlas manipulations:
atlas_core_add(),
atlas_manipulation,
atlas_relabel(),
atlas_structure_reorder(),
drawing_manipulation,
region_manipulation
Examples
# Views are named by the atlas, so ask it rather than naming one here.
dk() |> atlas_view_keep(atlas_views(dk())[1])
#>
#> ── dk ggseg atlas ──────────────────────────────────────────────────────────────
#> Type: cortical
#> Regions: 35
#> Hemispheres: left, right
#> Views: inferior
#> Palette: ✔
#> Rendering: ✔ ggseg
#> ✔ ggseg3d (vertices)
#> ────────────────────────────────────────────────────────────────────────────────
#> hemi region label
#> 1 left bankssts lh_bankssts
#> 2 left caudalanteriorcingulate lh_caudalanteriorcingulate
#> 3 left caudalmiddlefrontal lh_caudalmiddlefrontal
#> 4 left corpuscallosum lh_corpuscallosum
#> 5 left cuneus lh_cuneus
#> 6 left entorhinal lh_entorhinal
#> 7 left fusiform lh_fusiform
#> 8 left inferiorparietal lh_inferiorparietal
#> 9 left inferiortemporal lh_inferiortemporal
#> 10 left isthmuscingulate lh_isthmuscingulate
#> display lobe
#> 1 banks of superior temporal sulcus temporal
#> 2 caudal anterior cingulate cingulate
#> 3 caudal middle frontal frontal
#> 4 corpus callosum white matter
#> 5 cuneus occipital
#> 6 entorhinal temporal
#> 7 fusiform temporal
#> 8 inferior parietal parietal
#> 9 inferior temporal temporal
#> 10 isthmus cingulate cingulate
#> ... with 60 more rows
