Skip to main content

log

lq.tick-locate.log(x0, x1, base: 10, num-ticks-suggestion: 5, max-ticks: 200, density: 100%, linear-threshold: 2, ..args)(source)

Locates ticks on a logarithmic axis with range [x0,x1][x_0, x_1]. The range may be inverted, i.e., x0>x1x_0>x_1 but not x0=x1x_0 = x_1. Ticks are placed on powers of the base or if the range is too large, on every other power of the base (starting with the lower limit). In this case, the density of the ticks is determined by num-ticks-suggestion.

This function resolves to tick-locate.linear when the range is too small. The threshold is controlled by tick-locate.log.

This function returns a dictionary with the key ticks containing an array of tick positions.

Parameters

x0 : float

The start of the range to locate ticks for.

x1 : float

The end of the range to locate ticks for.

base : int    default: 10

The base of the logarithmic axis.

num-ticks-suggestion : int | float    default: 5

Suggested number of ticks to use. This may for example be chosen according to the length of the axis and the font size.

max-ticks : int    default: 200

The maximum number of ticks to generate. This guard prevents an accidental generation of a huge number of ticks.

density : ratio    default: 100%

The density of ticks. This can be used as a qualitative knob to tune the number of generated ticks in relation to the suggested number of ticks.

linear-threshold : float    default: 2

If log(x1/x0) is below this threshold, resolve to a linear tick locator. Set this to 0 to force logarithmic ticks.

..args : any

Ignored arguments that do not apply to this locator.