Class: Theme

A project’s whole look in one declarable object: its colours (inherited from Palette) and the geometry a style sheet used to own — tick shape, axis weight, line weights, legend, grid, font. Declared on a figure, it beats every layer in Figure.style, so a look a spec states cannot be quietly overridden by a sheet underneath it. It is the reason a study need not ship a .mplstyle: a sheet is a backend’s vocabulary written outside the spec, where nothing validates it and no other backend can read it. TVB-O’s own is curated at tvbo:theme/default; a project names that in iri and states only what it changes, exactly as an Observation or a Coupling reuses a curated one. A slot left unset is not a value — the layer underneath keeps it, so a theme states the look it means to fix and nothing else.

URI: tvbo:class/Theme

 classDiagram
    class Theme
    click Theme href "./Theme.html"
      Palette <|-- Theme
        click Palette href "./Palette.html"
      
      Theme : axis_width
        
          
    
        
        
        Theme --> "0..1" Float : axis_width
        click Float href "../http://www.w3.org/2001/XMLSchema#float.html"
    

        
      Theme : background
        
          
    
        
        
        Theme --> "0..1" String : background
        click String href "../http://www.w3.org/2001/XMLSchema#string.html"
    

        
      Theme : base
        
          
    
        
        
        Theme --> "0..1" String : base
        click String href "../http://www.w3.org/2001/XMLSchema#string.html"
    

        
      Theme : colormaps
        
          
    
        
        
        Theme --> "0..1" Colormaps : colormaps
        click Colormaps href "./Colormaps.html"
    

        
      Theme : font_family
        
          
    
        
        
        Theme --> "*" String : font_family
        click String href "../http://www.w3.org/2001/XMLSchema#string.html"
    

        
      Theme : grid_lines
        
          
    
        
        
        Theme --> "0..1" Boolean : grid_lines
        click Boolean href "../http://www.w3.org/2001/XMLSchema#boolean.html"
    

        
      Theme : highlight
        
          
    
        
        
        Theme --> "0..1" String : highlight
        click String href "../http://www.w3.org/2001/XMLSchema#string.html"
    

        
      Theme : ink
        
          
    
        
        
        Theme --> "0..1" String : ink
        click String href "../http://www.w3.org/2001/XMLSchema#string.html"
    

        
      Theme : iri
        
          
    
        
        
        Theme --> "0..1" Uriorcurie : iri
        click Uriorcurie href "../http://www.w3.org/2001/XMLSchema#anyURI.html"
    

        
      Theme : label_pad
        
          
    
        
        
        Theme --> "0..1" Float : label_pad
        click Float href "../http://www.w3.org/2001/XMLSchema#float.html"
    

        
      Theme : legend_frame
        
          
    
        
        
        Theme --> "0..1" Boolean : legend_frame
        click Boolean href "../http://www.w3.org/2001/XMLSchema#boolean.html"
    

        
      Theme : legend_handle_length
        
          
    
        
        
        Theme --> "0..1" Float : legend_handle_length
        click Float href "../http://www.w3.org/2001/XMLSchema#float.html"
    

        
      Theme : legend_pad
        
          
    
        
        
        Theme --> "0..1" Float : legend_pad
        click Float href "../http://www.w3.org/2001/XMLSchema#float.html"
    

        
      Theme : line_width
        
          
    
        
        
        Theme --> "0..1" Float : line_width
        click Float href "../http://www.w3.org/2001/XMLSchema#float.html"
    

        
      Theme : marker_size
        
          
    
        
        
        Theme --> "0..1" Float : marker_size
        click Float href "../http://www.w3.org/2001/XMLSchema#float.html"
    

        
      Theme : minor_tick_length
        
          
    
        
        
        Theme --> "0..1" Float : minor_tick_length
        click Float href "../http://www.w3.org/2001/XMLSchema#float.html"
    

        
      Theme : minor_tick_width
        
          
    
        
        
        Theme --> "0..1" Float : minor_tick_width
        click Float href "../http://www.w3.org/2001/XMLSchema#float.html"
    

        
      Theme : minor_ticks
        
          
    
        
        
        Theme --> "0..1" Boolean : minor_ticks
        click Boolean href "../http://www.w3.org/2001/XMLSchema#boolean.html"
    

        
      Theme : muted
        
          
    
        
        
        Theme --> "0..1" String : muted
        click String href "../http://www.w3.org/2001/XMLSchema#string.html"
    

        
      Theme : palette
        
          
    
        
        
        Theme --> "*" String : palette
        click String href "../http://www.w3.org/2001/XMLSchema#string.html"
    

        
      Theme : tick_direction
        
          
    
        
        
        Theme --> "0..1" TickDirection : tick_direction
        click TickDirection href "../../enums/TickDirection.html"
    

        
      Theme : tick_length
        
          
    
        
        
        Theme --> "0..1" Float : tick_length
        click Float href "../http://www.w3.org/2001/XMLSchema#float.html"
    

        
      Theme : tick_pad
        
          
    
        
        
        Theme --> "0..1" Float : tick_pad
        click Float href "../http://www.w3.org/2001/XMLSchema#float.html"
    

        
      Theme : tick_width
        
          
    
        
        
        Theme --> "0..1" Float : tick_width
        click Float href "../http://www.w3.org/2001/XMLSchema#float.html"
    

        
      Theme : title_pad
        
          
    
        
        
        Theme --> "0..1" Float : title_pad
        click Float href "../http://www.w3.org/2001/XMLSchema#float.html"

Inheritance

Palette
- Theme

Slots

Name	Cardinality and Range	Description	Inheritance
iri	0..1 xsd:anyURI	The curated theme this one starts from (`tvbo:theme/default`)	direct
tick_length	0..1 xsd:float	Length of a major tick mark, in points	direct
tick_width	0..1 xsd:float	Line weight of a major tick mark, in points	direct
tick_direction	0..1 TickDirection	Whether tick marks point out of the axes, into them, or both	direct
tick_pad	0..1 xsd:float	Distance from a tick mark to its label, in points	direct
minor_ticks	0..1 xsd:boolean	Draw minor tick marks between the major ones	direct
minor_tick_length	0..1 xsd:float	Length of a minor tick mark, in points	direct
minor_tick_width	0..1 xsd:float	Line weight of a minor tick mark, in points	direct
axis_width	0..1 xsd:float	Line weight of the axes frame, in points	direct
label_pad	0..1 xsd:float	Distance from an axis label to its axis, in points	direct
title_pad	0..1 xsd:float	Distance from a panel title to the axes, in points	direct
line_width	0..1 xsd:float	Default weight of a drawn line, in points, for any layer whose own style does…	direct
marker_size	0..1 xsd:float	Default marker size, in points, for any layer whose own style does not fix on…	direct
legend_frame	0..1 xsd:boolean	Draw the box around a legend	direct
legend_handle_length	0..1 xsd:float	Length of a legend’s sample line, in font-size units	direct
legend_pad	0..1 xsd:float	Distance from a legend to the axes it sits against, in font-size units	direct
grid_lines	0..1 xsd:boolean	Draw the axes grid	direct
font_family	* xsd:string	The typefaces to set text in, most-wanted first (`[Helvetica, Arial, DejaVu S…	direct
ink	0..1 xsd:string	Text, spines and ticks: the near-black everything is read against	Palette
base	0..1 xsd:string	Standard lines, bars and markers, wherever the colour carries no meaning	Palette
muted	0..1 xsd:string	Hairlines and de-emphasised strokes: present, and not competing	Palette
highlight	0..1 xsd:string	The single emphasis colour, kept out of the cycler so it never lands on a pan…	Palette
background	0..1 xsd:string	The page the figure is printed on	Palette
palette	* xsd:string	The categorical hues, reached into only where a panel separates conditions	Palette
colormaps	0..1 Colormaps	The continuous scales, so both kinds of colour move together and no figure na…	Palette

Usages

used by	used in	type	used
Figure	theme	range	Theme

Identifier and Mapping Information

Schema Source

from schema: https://w3id.org/tvbo/figure

Mappings

Mapping Type	Mapped Value
self	tvbo:Theme
native	tvbo:Theme

LinkML Source

Direct

name: Theme
description: 'A project''s whole look in one declarable object: its colours (inherited
  from `Palette`) and the geometry a style sheet used to own — tick shape, axis weight,
  line weights, legend, grid, font. Declared on a figure, it beats every layer in
  `Figure.style`, so a look a spec states cannot be quietly overridden by a sheet
  underneath it. It is the reason a study need not ship a `.mplstyle`: a sheet is
  a backend''s vocabulary written outside the spec, where nothing validates it and
  no other backend can read it. TVB-O''s own is curated at `tvbo:theme/default`; a
  project names that in `iri` and states only what it changes, exactly as an `Observation`
  or a `Coupling` reuses a curated one. A slot left unset is not a value — the layer
  underneath keeps it, so a theme states the look it means to fix and nothing else.'
from_schema: https://w3id.org/tvbo/figure
is_a: Palette
slots:
- iri
slot_usage:
  iri:
    name: iri
    description: The curated theme this one starts from (`tvbo:theme/default`). Its
      slots are merged under this document's own, so a theme states only its differences.
attributes:
  tick_length:
    name: tick_length
    description: Length of a major tick mark, in points. The default for a panel's
      own `tick_length`.
    from_schema: https://w3id.org/tvbo/figure
    domain_of:
    - Panel
    - Inset
    - Theme
    range: float
  tick_width:
    name: tick_width
    description: Line weight of a major tick mark, in points.
    from_schema: https://w3id.org/tvbo/figure
    rank: 1000
    domain_of:
    - Theme
    range: float
  tick_direction:
    name: tick_direction
    description: Whether tick marks point out of the axes, into them, or both.
    from_schema: https://w3id.org/tvbo/figure
    rank: 1000
    domain_of:
    - Theme
    range: TickDirection
  tick_pad:
    name: tick_pad
    description: Distance from a tick mark to its label, in points.
    from_schema: https://w3id.org/tvbo/figure
    rank: 1000
    domain_of:
    - Theme
    range: float
  minor_ticks:
    name: minor_ticks
    description: Draw minor tick marks between the major ones.
    from_schema: https://w3id.org/tvbo/figure
    rank: 1000
    domain_of:
    - Theme
    range: boolean
  minor_tick_length:
    name: minor_tick_length
    description: Length of a minor tick mark, in points. Ignored unless `minor_ticks`
      is set.
    from_schema: https://w3id.org/tvbo/figure
    rank: 1000
    domain_of:
    - Theme
    range: float
  minor_tick_width:
    name: minor_tick_width
    description: Line weight of a minor tick mark, in points. Ignored unless `minor_ticks`
      is set.
    from_schema: https://w3id.org/tvbo/figure
    rank: 1000
    domain_of:
    - Theme
    range: float
  axis_width:
    name: axis_width
    description: Line weight of the axes frame, in points. A figure whose spines are
      heavier than its data is drawn the wrong way round.
    from_schema: https://w3id.org/tvbo/figure
    rank: 1000
    domain_of:
    - Theme
    range: float
  label_pad:
    name: label_pad
    description: Distance from an axis label to its axis, in points. The default for
      a panel's own `xlabel_pad`/`ylabel_pad`.
    from_schema: https://w3id.org/tvbo/figure
    rank: 1000
    domain_of:
    - Theme
    range: float
  title_pad:
    name: title_pad
    description: Distance from a panel title to the axes, in points.
    from_schema: https://w3id.org/tvbo/figure
    rank: 1000
    domain_of:
    - Theme
    range: float
  line_width:
    name: line_width
    description: Default weight of a drawn line, in points, for any layer whose own
      style does not fix one.
    from_schema: https://w3id.org/tvbo/figure
    rank: 1000
    domain_of:
    - Theme
    range: float
  marker_size:
    name: marker_size
    description: Default marker size, in points, for any layer whose own style does
      not fix one.
    from_schema: https://w3id.org/tvbo/figure
    rank: 1000
    domain_of:
    - Theme
    range: float
  legend_frame:
    name: legend_frame
    description: Draw the box around a legend.
    from_schema: https://w3id.org/tvbo/figure
    rank: 1000
    domain_of:
    - Theme
    range: boolean
  legend_handle_length:
    name: legend_handle_length
    description: Length of a legend's sample line, in font-size units.
    from_schema: https://w3id.org/tvbo/figure
    rank: 1000
    domain_of:
    - Theme
    range: float
  legend_pad:
    name: legend_pad
    description: Distance from a legend to the axes it sits against, in font-size
      units.
    from_schema: https://w3id.org/tvbo/figure
    rank: 1000
    domain_of:
    - Theme
    range: float
  grid_lines:
    name: grid_lines
    description: Draw the axes grid. Off in most journals, and worth stating either
      way rather than inheriting.
    from_schema: https://w3id.org/tvbo/figure
    rank: 1000
    domain_of:
    - Theme
    range: boolean
  font_family:
    name: font_family
    description: 'The typefaces to set text in, most-wanted first (`[Helvetica, Arial,
      DejaVu Sans]`). A generic family (`sans-serif`, `serif`, `monospace`) as the
      first entry selects that family outright; otherwise the list is taken as the
      concrete faces to try within `sans-serif`, which is how a person means it. Type
      SIZE is not here: `Figure.font_size` owns it, because it is a property of the
      figure''s print size rather than of the project''s look.'
    from_schema: https://w3id.org/tvbo/figure
    rank: 1000
    domain_of:
    - Theme
    range: string
    multivalued: true

Induced

name: Theme
description: 'A project''s whole look in one declarable object: its colours (inherited
  from `Palette`) and the geometry a style sheet used to own — tick shape, axis weight,
  line weights, legend, grid, font. Declared on a figure, it beats every layer in
  `Figure.style`, so a look a spec states cannot be quietly overridden by a sheet
  underneath it. It is the reason a study need not ship a `.mplstyle`: a sheet is
  a backend''s vocabulary written outside the spec, where nothing validates it and
  no other backend can read it. TVB-O''s own is curated at `tvbo:theme/default`; a
  project names that in `iri` and states only what it changes, exactly as an `Observation`
  or a `Coupling` reuses a curated one. A slot left unset is not a value — the layer
  underneath keeps it, so a theme states the look it means to fix and nothing else.'
from_schema: https://w3id.org/tvbo/figure
is_a: Palette
slot_usage:
  iri:
    name: iri
    description: The curated theme this one starts from (`tvbo:theme/default`). Its
      slots are merged under this document's own, so a theme states only its differences.
attributes:
  tick_length:
    name: tick_length
    description: Length of a major tick mark, in points. The default for a panel's
      own `tick_length`.
    from_schema: https://w3id.org/tvbo/figure
    owner: Theme
    domain_of:
    - Panel
    - Inset
    - Theme
    range: float
  tick_width:
    name: tick_width
    description: Line weight of a major tick mark, in points.
    from_schema: https://w3id.org/tvbo/figure
    rank: 1000
    owner: Theme
    domain_of:
    - Theme
    range: float
  tick_direction:
    name: tick_direction
    description: Whether tick marks point out of the axes, into them, or both.
    from_schema: https://w3id.org/tvbo/figure
    rank: 1000
    owner: Theme
    domain_of:
    - Theme
    range: TickDirection
  tick_pad:
    name: tick_pad
    description: Distance from a tick mark to its label, in points.
    from_schema: https://w3id.org/tvbo/figure
    rank: 1000
    owner: Theme
    domain_of:
    - Theme
    range: float
  minor_ticks:
    name: minor_ticks
    description: Draw minor tick marks between the major ones.
    from_schema: https://w3id.org/tvbo/figure
    rank: 1000
    owner: Theme
    domain_of:
    - Theme
    range: boolean
  minor_tick_length:
    name: minor_tick_length
    description: Length of a minor tick mark, in points. Ignored unless `minor_ticks`
      is set.
    from_schema: https://w3id.org/tvbo/figure
    rank: 1000
    owner: Theme
    domain_of:
    - Theme
    range: float
  minor_tick_width:
    name: minor_tick_width
    description: Line weight of a minor tick mark, in points. Ignored unless `minor_ticks`
      is set.
    from_schema: https://w3id.org/tvbo/figure
    rank: 1000
    owner: Theme
    domain_of:
    - Theme
    range: float
  axis_width:
    name: axis_width
    description: Line weight of the axes frame, in points. A figure whose spines are
      heavier than its data is drawn the wrong way round.
    from_schema: https://w3id.org/tvbo/figure
    rank: 1000
    owner: Theme
    domain_of:
    - Theme
    range: float
  label_pad:
    name: label_pad
    description: Distance from an axis label to its axis, in points. The default for
      a panel's own `xlabel_pad`/`ylabel_pad`.
    from_schema: https://w3id.org/tvbo/figure
    rank: 1000
    owner: Theme
    domain_of:
    - Theme
    range: float
  title_pad:
    name: title_pad
    description: Distance from a panel title to the axes, in points.
    from_schema: https://w3id.org/tvbo/figure
    rank: 1000
    owner: Theme
    domain_of:
    - Theme
    range: float
  line_width:
    name: line_width
    description: Default weight of a drawn line, in points, for any layer whose own
      style does not fix one.
    from_schema: https://w3id.org/tvbo/figure
    rank: 1000
    owner: Theme
    domain_of:
    - Theme
    range: float
  marker_size:
    name: marker_size
    description: Default marker size, in points, for any layer whose own style does
      not fix one.
    from_schema: https://w3id.org/tvbo/figure
    rank: 1000
    owner: Theme
    domain_of:
    - Theme
    range: float
  legend_frame:
    name: legend_frame
    description: Draw the box around a legend.
    from_schema: https://w3id.org/tvbo/figure
    rank: 1000
    owner: Theme
    domain_of:
    - Theme
    range: boolean
  legend_handle_length:
    name: legend_handle_length
    description: Length of a legend's sample line, in font-size units.
    from_schema: https://w3id.org/tvbo/figure
    rank: 1000
    owner: Theme
    domain_of:
    - Theme
    range: float
  legend_pad:
    name: legend_pad
    description: Distance from a legend to the axes it sits against, in font-size
      units.
    from_schema: https://w3id.org/tvbo/figure
    rank: 1000
    owner: Theme
    domain_of:
    - Theme
    range: float
  grid_lines:
    name: grid_lines
    description: Draw the axes grid. Off in most journals, and worth stating either
      way rather than inheriting.
    from_schema: https://w3id.org/tvbo/figure
    rank: 1000
    owner: Theme
    domain_of:
    - Theme
    range: boolean
  font_family:
    name: font_family
    description: 'The typefaces to set text in, most-wanted first (`[Helvetica, Arial,
      DejaVu Sans]`). A generic family (`sans-serif`, `serif`, `monospace`) as the
      first entry selects that family outright; otherwise the list is taken as the
      concrete faces to try within `sans-serif`, which is how a person means it. Type
      SIZE is not here: `Figure.font_size` owns it, because it is a property of the
      figure''s print size rather than of the project''s look.'
    from_schema: https://w3id.org/tvbo/figure
    rank: 1000
    owner: Theme
    domain_of:
    - Theme
    range: string
    multivalued: true
  iri:
    name: iri
    description: The curated theme this one starts from (`tvbo:theme/default`). Its
      slots are merged under this document's own, so a theme states only its differences.
    from_schema: https://w3id.org/tvbo
    rank: 1000
    slot_uri: dcterms:identifier
    owner: Theme
    domain_of:
    - DataRef
    - Theme
    - Parcellation
    - Tractogram
    - ResultEntity
    - Activity
    - ReferenceFingerprint
    - GraphGenerator
    - Reference
    - Observation
    - Dynamics
    - Function
    - FunctionCall
    - Coupling
    range: uriorcurie
  ink:
    name: ink
    description: 'Text, spines and ticks: the near-black everything is read against.'
    from_schema: https://w3id.org/tvbo/figure
    rank: 1000
    owner: Theme
    domain_of:
    - Palette
    range: string
  base:
    name: base
    description: Standard lines, bars and markers, wherever the colour carries no
      meaning. Leads the cycler.
    from_schema: https://w3id.org/tvbo/figure
    rank: 1000
    owner: Theme
    domain_of:
    - Palette
    range: string
  muted:
    name: muted
    description: 'Hairlines and de-emphasised strokes: present, and not competing.'
    from_schema: https://w3id.org/tvbo/figure
    rank: 1000
    owner: Theme
    domain_of:
    - Palette
    range: string
  highlight:
    name: highlight
    description: The single emphasis colour, kept out of the cycler so it never lands
      on a panel by accident.
    from_schema: https://w3id.org/tvbo/figure
    rank: 1000
    owner: Theme
    domain_of:
    - Palette
    range: string
  background:
    name: background
    description: The page the figure is printed on.
    from_schema: https://w3id.org/tvbo/figure
    rank: 1000
    owner: Theme
    domain_of:
    - Palette
    range: string
  palette:
    name: palette
    description: The categorical hues, reached into only where a panel separates conditions.
      Ordered, and named by index from zero (`palette.0` is the first), so inserting
      a hue recolours every figure that names one after it.
    from_schema: https://w3id.org/tvbo/figure
    rank: 1000
    owner: Theme
    domain_of:
    - Palette
    range: string
    multivalued: true
  colormaps:
    name: colormaps
    description: The continuous scales, so both kinds of colour move together and
      no figure names a colormap of its own.
    from_schema: https://w3id.org/tvbo/figure
    rank: 1000
    owner: Theme
    domain_of:
    - Palette
    range: Colormaps
    inlined: true