Function cg = colourgrade_map(cg)
returns struct cg with renewed fields
defining the colourmap based on the
given information in
-- the series of grade values,
-- the colourmap function handle,
-- and possibly rgb vectors for special
colours.
At input, the struct cg may have the following
optional fields:
cg.gradevalues (column vector of reals)
cg.gradeticks (column vector of booleans)
cg.gradetexts (column cell-array of strings)
cg.colourmapfun (colourmap function handle)
cg.colour_infra (rgb vector)
cg.colour_ultra (rgb vector)
cg.colour_nanan (rgb vector)
cg.dcm: (scalar integer >= 1)
cg.dcm_begin: (scalar integer >= 1)
cg.dcm_extra: (scalar integer >= 1)
cg.dcm_end: (scalar integer >= 1)
cg.fcm_begin: (empty or scalar real > 0)
cg.fcm_extra: (empty or scalar real > 0)
cg.fcm_end: (empty or scalar real > 0)
At output, the struc cg contains new or renewed
fields:
cg.colourmap (colourmap, an N*3 matrix
for N colours in total)
cg.icm_infra (row index to cg.colourmap)
cg.icm_min (row index to cg.colourmap)
cg.icm_max (row index to cg.colourmap)
cg.icm_ultra (row index to cg.colourmap)
cg.icm_nanan (row index to cg.colourmap)
The output struc cg contains also any
other fields with defaults defined by
m-file colourgrade_init.m.
The function internally calls the following
non-standard m-files:
colourgrade_init.m
colourgrade_init_ngrade.m
(c) 2026 fabien van mook
2026.08.20 release of this file within package "fvm-colourgrade" under GNU GPLv3+
