Bio::G...at_map(3pm)

💅 NAME

okay bestie, so this is Bio::Graphics::Glyph::heat_map — it's the "heat_map" glyph. that's it, that's the name. iconic honestly. this whole page is from the Bio::G...at_map(3pm) manual and we're about to go through every last crumb of it together 🫶

---

✨ SYNOPSIS

See Bio::Graphics::Panel and Bio::Graphics::Glyph.

like, go read those first, i'm not gonna re-explain the whole ecosystem when they already ate 💅

---

💖 DESCRIPTION

so this glyph draws "scored" features and it does it using a continuous color gradient — and the gradient lives in the HSV color space, which is the moment. the color of each segment is proportionate to the score. that's the whole vibe: bigger score, different color, gradient goes brrr 🌈

---

🎀 OPTIONS

Global glyph options

go check Bio::Graphics::Glyph::generic — all the global stuff lives there, not here, so don't come for me 🫶

Glyph-specific options

now THIS is the good part. the color_map glyph recognizes the following glyph-specific options (yes, the original page says "color_map", i'm just relaying the message, no notes):

• -start_color — beginning of the color gradient, expressed as a named color or an RGB hex string. default: white
• -end_color — end of the color gradient. default: red
• -brightness — color brilliance, 0-100. this will override the value from the named color. default: Calculated
• -saturation — color saturation, 0-100. this will override the value from the named color. default: Calculated
• -pure_hue — use the pure hue (brightness and saturation both at 100) for the named color. default: 0 (false)
• -max_score — maximum value of the feature's "score" attribute. default: Calculated
• -min_score — minimum value of the feature's "score" attribute. default: Calculated
• -vary_fg — vary the foreground color with the background color. default: 1 (true)

⚠️ okay important bestie, listen: if max_score and min_score are not specified, the glyph will calculate the local maximum and minimum scores at run time. if single features, unaggregated features, or multiple aggregates are being drawn, this will result in an inconsistent color scale. it is recommended that global maximum and minimum scores be specified in the track configuration. and since many scoring functions are exponential, you may wish to take the log of your scores before passing them to this glyph. like, do the math first, don't just send it raw 😭

🌈 Color Gradients

the color gradient is calculated by progressing along the rainbow spectrum from red to violet, also incrementing brightness and saturation, all proportionate to the score value (the original spells it "proportate", we love a typo moment, no cap). to vary the hue only, "pure" hues can be used — pure hues have brightness and saturation values of 100. some examples, in order, are red, yellow, lime, aqua/cyan, blue and magenta. and get this: the gradient can progress in reverse orientation with respect to the visible light spectrum if a lower-order color is used as the start and a higher-order color is used as the end (for example lime->red). slay.

using the "pure_hue" option results in a brighter, more vibrant color spectrum. choosing darker start and end colors, such as green or maroon, will result in a darker spectrum. and a single color spectrum can be created by using black or white as the start or end color. 💀

a grayscale spectrum will result if black and white are used as start and end colors. one example of an effective visual heat map is to progress from white->red. chef's kiss, honestly 👑

for the start_color and end_color options, 140 named webcolors and their corresponding RGB hex codes (listed below) are supported. here's the full palette, every single one, i would never gatekeep:

 steelblue              #4682B4
 royalblue              #041690
 cornflowerblue         #6495ED
 lightsteelblue         #B0C4DE
 mediumslateblue        #7B68EE
 slateblue              #6A5ACD
 darkslateblue          #483D8B
 midnightblue           #191970
 navy                   #000080
 darkblue               #00008B
 mediumblue             #0000CD
 blue                   #0000FF
 dodgerblue             #1E90FF
 deepskyblue            #00BFFF
 lightskyblue           #87CEFA
 skyblue                #87CEEB
 lightblue              #ADD8E6
 powderblue             #B0E0E6
 azure                  #F0FFFF
 lightcyan              #E0FFFF
 paleturquoise          #AFEEEE
 mediumturquoise        #48D1CC
 lightseagreen          #20B2AA
 darkcyan               #008B8B
 teal                   #008080
 cadetblue              #5F9EA0
 darkturquoise          #00CED1
 aqua                   #00FFFF
 cyan                   #00FFFF
 turquoise              #40E0D0
 aquamarine             #7FFFD4
 mediumaquamarine       #66CDAA
 darkseagreen           #8FBC8F
 mediumseagreen         #3CB371
 seagreen               #2E8B57
 darkgreen              #006400
 green                  #008000
 forestgreen            #228B22
 limegreen              #32CD32
 lime                   #00FF00
 chartreuse             #7FFF00
 lawngreen              #7CFC00
 greenyellow            #ADFF2F
 yellowgreen            #9ACD32
 palegreen              #98FB98
 lightgreen             #90EE90
 springgreen            #00FF7F
 mediumspringgreen      #00FA9A
 darkolivegreen         #556B2F
 olivedrab              #6B8E23
 olive                  #808000
 darkkhaki              #BDB76B
 darkgoldenrod          #B8860B
 goldenrod              #DAA520
 gold                   #FFD700
 yellow                 #FFFF00
 khaki                  #F0E68C
 palegoldenrod          #EEE8AA
 blanchedalmond         #FFEBCD
 moccasin               #FFE4B5
 wheat                  #F5DEB3
 navajowhite            #FFDEAD
 burlywood              #DEB887
 tan                    #D2B48C
 rosybrown              #BC8F8F
 sienna                 #A0522D
 saddlebrown            #8B4513
 chocolate              #D2691E
 peru                   #CD853F
 sandybrown             #F4A460
 darkred                #8B0000
 maroon                 #800000
 brown                  #A52A2A
 firebrick              #B22222
 indianred              #CD5C5C
 lightcoral             #F08080
 salmon                 #FA8072
 darksalmon             #E9967A
 lightsalmon            #FFA07A
 coral                  #FF7F50
 tomato                 #FF6347
 darkorange             #FF8C00
 orange                 #FFA500
 orangered              #FF4500
 crimson                #DC143C
 red                    #FF0000
 deeppink               #FF1493
 fuchsia                #FF00FF
 magenta                #FF00FF
 hotpink                #FF69B4
 lightpink              #FFB6C1
 pink                   #FFC0CB
 palevioletred          #DB7093
 mediumvioletred        #C71585
 purple                 #800080
 darkmagenta            #8B008B
 mediumpurple           #9370DB
 blueviolet             #8A2BE2
 indigo                 #4B0082
 darkviolet             #9400D3
 darkorchid             #9932CC
 mediumorchid           #BA55D3
 orchid                 #DA70D6
 violet                 #EE82EE
 plum                   #DDA0DD
 thistle                #D8BFD8
 lavender               #E6E6FA
 ghostwhite             #F8F8FF
 aliceblue              #F0F8FF
 mintcream              #F5FFFA
 honeydew               #F0FFF0
 lightgoldenrodyellow   #FAFAD2
 lemonchiffon           #FFFACD
 cornsilk               #FFF8DC
 lightyellow            #FFFFE0
 ivory                  #FFFFF0
 floralwhite            #FFFAF0
 linen                  #FAF0E6
 oldlace                #FDF5E6
 antiquewhite           #FAEBD7
 bisque                 #FFE4C4
 peachpuff              #FFDAB9
 papayawhip             #FFEFD5
 beige                  #F5F5DC
 seashell               #FFF5EE
 lavenderblush          #FFF0F5
 mistyrose              #FFE4E1
 snow                   #FFFAFA
 white                  #FFFFFF
 whitesmoke             #F5F5F5
 gainsboro              #DCDCDC
 lightgrey              #D3D3D3
 silver                 #C0C0C0
 darkgray               #A9A9A9
 gray                   #808080
 lightslategray         #778899
 slategray              #708090
 dimgray                #696969
 darkslategray          #2F4F4F
 black                  #000000

---

🐛 BUGS

Please report them. (that's genuinely all it says bestie, no elaboration, no template, just "Please report them." — the brevity is lowkey sending me 💀)

---

👀 SEE ALSO

• Bio::Graphics::Panel
• Bio::Graphics::Glyph
• Bio::Graphics::Glyph::graded_segments
• Bio::Graphics::Glyph::heterogeneous_segments
• Bio::Graphics::Feature
• Bio::DB::GFF
• GD

---

👑 AUTHOR

Sheldon McKay <mckays@cshl.edu>

Copyright (c) 2006 Cold Spring Harbor Laboratory

This package and its accompanying libraries is free software; you can redistribute it and/or modify it under the terms of the GPL (either version 1, or at your option, any later version) or the Artistic License 2.0. Refer to LICENSE for the full license text. In addition, please see DISCLAIMER.txt for disclaimers of warranty.

---

okay that's the whole thing, you made it to the end, so proud 🥹 this page came to you courtesy of perl v5.30.0, dated 2019-11-25, straight out of Bio::G...at_map(3pm). go forth and make a beautiful gradient, bestie 💖✨🦋