Other Options

ProfileSVG.view and ProfileSVG.save have optional keyword arguments for specifying the SVG styles.

yflip

The yflip option inverts the depth direction. It defaults to false and a "flame" graph with upward depth will be rendered. By setting yflip to true, a "icicle" graph with downward depth will be rendered.

ProfileSVG.view(yflip=true)

maxdepth and maxframes

The maxdepth option limits the maximum number of the rendered rows of graph. The frames deeper than maxdepth (i.e. away from the root) will be truncated.

The maxframes option limits the maximum number of the rendered frames. Since the frames are rendered in order of depth-first search, the frames to the right tend to be omitted.

When maxdepth and/or maxframes are reached, warnings will be displayed.

ProfileSVG.view(maxdepth=7, maxframes=12)

width and height

The width and height options specify the size of the SVG image in pixels. However, the actual display scale depends on the viewer.

If you set the height to 0, it will be calculated automatically according to the graph. As shown below, cropping can occur when the height of the graph exceeds the manually specified height. When the interactive feature is available, you can display the cropped area by dragging the graph.

ProfileSVG.view(width=400, height=200)

roundradius

The raoundradius option specifies the rounding radius of the corners of each frame in pixels.

ProfileSVG.view(roundradius=6)

font and fontsize

The font option specifies the font family names for texts. This setting is used as the CSS font-family property, i.e. you can use a comma-separated list and quotes are required around the names which are not valid CSS identifiers.

The fontsize option specifies the font size in pixels.

Note that the actual rendering results depend on the viewer.

ProfileSVG.view(font="'Times New Roman', serif", fontsize=16)

notext

The notext option specifies the visibility of overlaid texts on the frames. If the notext is true, the texts will be hidden by the interactive feature and the rendering load is significantly reduced.

ProfileSVG.view(notext=true)

timeunit and delay

The timeunit option specifies the time unit for displaying the duration (span) of active block. One of the following symbols is available for timeunit:

• :none (default)
  • disabling the duration display
• :s, :ms, :us, or :µs
  • using the physical time unit
• others (e.g. :ticks)
  • using the discrete sampling count

The delay option specifies the delay between backtraces, in seconds. The value will be used for the conversion from the discrete sampling count to the physical time. If a non-positive number is specified, the current setting in the return value of Profile.init() will be used.

ProfileSVG.view(timeunit=:ticks)

Profile.init(delay=1e-4)
ProfileSVG.view(timeunit=:ms)

ProfileSVG.view(timeunit=:µs, delay=3e-4)

title

The title option specifies the title (caption) of the graph.

Setting options as default

You can specify the default values for options with ProfileSVG.set_default.

You can also reset the settings with ProfileSVG.init.

ProfileSVG.set_default(StackFrameCategory(), roundradius=0, title="<default>",
                       font="system-ui", fontsize=8)
ProfileSVG.view(width=300)