The TikZ and PGF Packages
Manual for version 3.1.10
Mathematical and ObjectOriented Engines
97 Number Printing¶
An extension by Christian Feuersänger
pgf supports number printing in different styles and rounds to arbitrary precision.

\pgfmathprintnumber{⟨x⟩} ¶
Generates prettyprinted output for the (real) number ⟨x⟩. The input number ⟨x⟩ is parsed using \pgfmathfloatparsenumber which allows arbitrary precision.
Numbers are typeset in math mode using the current set of number printing options, see below. Optional arguments can also be provided using \pgfmathprintnumber[⟨options⟩]⟨x⟩.

\pgfmathprintnumberto{⟨x⟩}{⟨macro⟩} ¶
Returns the resulting number into ⟨macro⟩ instead of typesetting it directly.

/pgf/number format/sci(no value) ¶
Configures \pgfmathprintnumber to display numbers in scientific format, that means sign, mantissa and exponent (basis \(10\)). The mantissa is rounded to the desired precision (or sci precision, see below).
See section 97.1 for how to change the exponential display style.

/pgf/number format/sci zerofill={⟨boolean⟩} (default true) ¶
Enables or disables zero filling for any number drawn in scientific format.
As with fixed zerofill, this option does only affect numbers drawn in sci format (or std if the scientific format is chosen).
See section 97.1 for how to change the exponential display style.

/pgf/number format/zerofill={⟨boolean⟩} (style, default true) ¶
Sets both fixed zerofill and sci zerofill at once.

/pgf/number format/std(no value) ¶

/pgf/number format/std=⟨lower e⟩(no default)

/pgf/number format/std=⟨lower e⟩:⟨upper e⟩(no default)
Configures \pgfmathprintnumber to a standard algorithm. It chooses either fixed or sci, depending on the order of magnitude. Let \(n=s \cdot m \cdot 10^e\) be the input number and \(p\) the current precision. If \(p/2 \le e \le 4\), the number is displayed using fixed format. Otherwise, it is displayed using sci format.
The parameters can be customized using the optional integer argument(s): if \(\text {\meta {lower e}} \le e \le \text {\meta {upper e}}\), the number is displayed in fixed format, otherwise in sci format. Note that ⟨lower e⟩ should be negative for useful results. The precision used for the scientific format can be adjusted with sci precision if necessary.

/pgf/number format/relative*=⟨exponent base 10⟩(no default) ¶
Configures \pgfmathprintnumber to format numbers relative to an order of magnitude, \(10^r\), where \(r\) is an integer number.
This key addresses different usecases.
provide a unified format for a sequence of numbers. Consider the following test:
With any other style, the 6.42e16 would have been formatted as an isolated number. Here, it is rounded to 0 because when viewed relative to \(10^1\) (the exponent \(1\) is the argument for relative), it has no significant digits.
The example above applies the initial precision=2 to 123.345 – relative to \(100\). Two significant digits of 123.345 relative to \(100\) are 123. Note that the “\(2\) significant digits of 123.345” translates to “round 1.2345 to \(2\) digits”, which would yield 1.2300. Similarly, the other two numbers are 0 compared to \(100\) using the given precision.
improve rounding in the presence of inaccurate numbers. Let us suppose that some limitedprecision arithmetic resulted in the result 123456999 (like the fpu of pgf). You know that its precision is about five or six significant digits. And you want to provide a fixed point output. In this case, the trailing digits ....999 are a numerical artifact due to the limited precision. Use relative*=3,precision=0 to eliminate the artifacts:
Here, precision=0 means that we inspect 123456.999 and round that number to \(0\) digits. Finally, we move the period back to its initial position. Adding relative style=fixed results in fixed point output format:
Note that there is another alternative for this usecase which is discussed later: the fixed relative style.
You might wonder why there is an asterisk in the key’s name. The short answer is: there is also a /pgf/number format/relative number printer which does unexpected things. The key relative* repairs this. Existing code will still use the old behavior.
Technically, the key works as follows: as already explained above, relative*=3 key applied to 123456999.12 moves the period by three positions and analyzes 123456.99912. Mathematically speaking, we are given a number \(x = \pm m \cdot 10^e\) and we attempt to apply relative*=\(r\). The method then rounds \(x / 10^r\) to precision digits. Afterwards, it multiplies the result by \(10^r\) and typesets it.

/pgf/number format/every relative(style, no value) ¶
A style which configures how the relative method finally displays its results.
The initial configuration is
Note that rounding is turned off when the resulting style is being evaluated (since relative already rounded the number).
Although supported, I discourage from using fixed zerofill or sci zerofill in this context – it may lead to a suggestion of higher precision than is actually used (because fixed zerofill might simply add .00 although there was a different information before relative rounded the result).

/pgf/number format/relative style={⟨options⟩}(no default) ¶
The same as every relative/.append style={⟨options⟩}.

/pgf/number format/fixed relative(no value) ¶
Configures \pgfmathprintnumber to format numbers in a similar way to the fixed style, but the precision is interpreted relatively to the number’s exponent.
The motivation is to get the same rounding effect as for sci, but to display the number in the fixed style:
The effect of fixed relative is that the number is rounded to exactly the first ⟨precision⟩ nonzero digits, no matter how many leading zeros the number might have.
Use fixed relative if you want fixed and if you know that only the first \(n\) digits are correct. Use sci if you need a scientific display style and only the first \(n\) digits are correct.
Note that fixed relative ignores the fixed zerofill flag.
See also the relative* key. Note that the relative={⟨exponent⟩} key explicitly moves the period to some designated position before it attempts to round the number. Afterwards, it “rounds from the right”, i.e. it rounds to that explicitly chosen digit position. In contrast to that, fixed relative “rounds from the left”: it takes the first nonzero digit, temporarily places the period after this digit, and rounds that number. The rounding style fixed leaves the period where it is, and rounds everything behind that digit. The sci style is similar to fixed relative.

/pgf/number format/int detect(no value) ¶
Configures \pgfmathprintnumber to detect integers automatically. If the input number is an integer, no period is displayed at all. If not, the scientific format is chosen.

\pgfmathifisint{⟨number constant⟩}{⟨true code⟩}{⟨false code⟩} ¶
A command which does the same check as int detect, but it invokes ⟨true code⟩ if the ⟨number constant⟩ actually is an integer and the ⟨false code⟩ if not.
As a sideeffect, \pgfretval will contain the parsed number, either in integer format or as parsed floating point number.
The argument ⟨number constant⟩ will be parsed with \pgfmathfloatparsenumber.

/pgf/number format/int trunc(no value) ¶
Truncates every number to integers (discards any digit after the period).

/pgf/number format/frac(no value) ¶

/pgf/number format/frac TeX={⟨\macro⟩} (no default, initially \frac) ¶

/pgf/number format/frac denom=⟨int⟩ (no default, initially empty) ¶

/pgf/number format/frac whole=truefalse (no default, initially true) ¶

/pgf/number format/frac shift={⟨integer⟩} (no default, initially 4) ¶
Displays numbers as fractionals.
Allows to use a different implementation for \frac inside of the frac display type.
Allows to provide a custom denominator for frac.
Configures whether complete integer parts shall be placed in front of the fractional part. In this case, the fractional part will be less then \(1\). Use frac whole=false to avoid whole number parts.
In case you experience problems because of stability problems, try experimenting with a different frac shift. Higher shift values \(k\) yield higher sensitivity to inaccurate data or inaccurate arithmetic.
Technically, the following happens. If \(r < 1\) is the fractional part of the mantissa, then a scale \(i = 1/r \cdot 10^k\) is computed where \(k\) is the shift; fractional parts of \(i\) are neglected. The value \(1/r\) is computed internally, its error is amplified.
If you still experience stability problems, use \usepackage{fp} in your preamble. The frac style will then automatically employ the higher absolute precision of fp for the computation of \(1/r\).

/pgf/number format/precision={⟨number⟩}(no default) ¶
Sets the desired rounding precision for any display operation. For scientific format, this affects the mantissa.

/pgf/number format/sci precision=⟨number or empty⟩ (no default, initially empty) ¶
Sets the desired rounding precision only for sci styles.
Use sci precision={} to restore the initial configuration (which uses the argument provided to precision for all number styles).

/pgf/number format/read comma as period=truefalse (no default, initially false) ¶
This is one of the few keys which allows to customize the number parser. If this switch is turned on, a comma is read just as a period.
This is typically undesired as it can cause sideeffects with math parsing instructions. However, it is supported to format input numbers or input tables. Consider use comma to typeset the result with a comma as well.
97.1 Changing display styles¶
You can change the way how numbers are displayed. For example, if you use the ‘fixed’ style, the input number is rounded to the desired precision and the current fixed point display style is used to typeset the number. The same is applied to any other format: first, rounding routines are used to get the correct digits, afterwards a display style generates proper TeXcode.

/pgf/number format/set decimal separator={⟨text⟩}(no default) ¶
Assigns {⟨text⟩} as decimal separator for any fixed point numbers (including the mantissa in sci format).
Use \pgfkeysgetvalue{/pgf/number format/set decimal separator}\value to get the current separator into \value.

/pgf/number format/dec sep={⟨text⟩}(style, no default) ¶
Just another name for set decimal separator.

/pgf/number format/set thousands separator={⟨text⟩}(no default) ¶
Assigns {⟨text⟩} as thousands separator for any fixed point numbers (including the mantissa in sci format).
The last example employs commas and disables the default commaspacing.
Use \pgfkeysgetvalue{/pgf/number format/set thousands separator}\value to get the current separator into \value.

/pgf/number format/1000 sep={⟨text⟩}(style, no default) ¶
Just another name for set thousands separator.

/pgf/number format/1000 sep in fractionals={⟨boolean⟩} (no default, initially false) ¶
Configures whether the fractional part should also be grouped into groups of three digits.
The value true will active the 1000 sep for both, integer and fractional parts. The value false will active 1000 sep only for the integer part.
Testing comma to see what happens after the end of key.

/pgf/number format/min exponent for 1000 sep={⟨number⟩} (no default, initially 0) ¶
Defines the smallest exponent in scientific notation which is required to draw thousand separators. The exponent is the number of digits minus one, so \(\meta {number}=4\) will use thousand separators starting with \(1e4 = 10000\).
A value of 0 disables this feature (negative values are ignored).
Checking comma.

/pgf/number format/use period(no value) ¶
A predefined style which installs periods “.” as decimal separators and commas “,” as thousands separators. This style is the default.

/pgf/number format/use comma(no value) ¶
A predefined style which installs commas “,” as decimal separators and periods “.” as thousands separators.

/pgf/number format/skip 0.={⟨boolean⟩} (no default, initially false) ¶
Configures whether numbers like \(0.1\) shall be typeset as \(.1\) or not.

/pgf/number format/showpos={⟨boolean⟩} (no default, initially false) ¶
Enables or disables the display of plus signs for nonnegative numbers.

/pgf/number format/print sign={⟨boolean⟩}(style, no default) ¶
A style which is simply an alias for showpos={⟨boolean⟩}.

/pgf/number format/sci 10e(no value) ¶
Uses \(m \cdot 10^e\) for any number displayed in scientific format.

/pgf/number format/sci 10^e(no value) ¶
The same as ‘sci 10e’.

/pgf/number format/sci e(no value) ¶
Uses the ‘\(1e{+}0\)’ format which is generated by common scientific tools for any number displayed in scientific format.

/pgf/number format/sci E(no value) ¶
The same with an uppercase ‘E’.

/pgf/number format/sci subscript(no value) ¶
Typesets the exponent as subscript for any number displayed in scientific format. This style requires very little space.

/pgf/number format/sci superscript(no value) ¶
Typesets the exponent as superscript for any number displayed in scientific format. This style requires very little space.

/pgf/number format/sci generic={⟨keys⟩}(no default) ¶

/pgf/number format/sci generic/mantissa sep={⟨text⟩} (no default, initially empty) ¶

/pgf/number format/sci generic/exponent={⟨text⟩} (no default, initially empty) ¶
Allows to define an own number style for the scientific format. Here, ⟨keys⟩ can be one of the following choices (omit the long key prefix):
Provides the separator between a mantissa and the exponent. It might be \cdot, for example,
Provides text to format the exponent. The actual exponent is available as argument #1 (see below).
The ⟨keys⟩ can depend on three parameters, namely on #1 which is the exponent, #2 containing the flags entity of the floating point number and #3 is the (unprocessed and unformatted) mantissa.
Note that sci generic is not suitable to modify the appearance of fixed point numbers, nor can it be used to format the mantissa (which is typeset like fixed point numbers). Use dec sep, 1000 sep and print sign to customize the mantissa.

/pgf/number format/retain unit mantissa=truefalse (no default, initially true) ¶
Allows to omit a unit mantissa.
The feature is applied after rounding to the desired precision: if the remaining mantissa is equal to \(1\), it will be omitted. It applies to all styles involving the scientific format (including std).

/pgf/number format/@dec sep mark={⟨text⟩}(no default) ¶
Will be placed right before the place where a decimal separator belongs to. However, {⟨text⟩} will be inserted even if there is no decimal separator. It is intended as placeholder for auxiliary routines to find alignment positions.
This key should never be used to change the decimal separator! Use dec sep instead.

/pgf/number format/@sci exponent mark={⟨text⟩}(no default) ¶
Will be placed right before exponents in scientific notation. It is intended as placeholder for auxiliary routines to find alignment positions.
This key should never be used to change the exponent!

/pgf/number format/assume math mode={⟨boolean⟩} (default true) ¶
Set this to true if you don’t want any checks for math mode. The initial setting checks whether math mode is active using \pgfutilensuremath for each final number.
Use assume math mode=true if you know that math mode is active. In that case, the final number is typeset asis, no further checking is performed.

/pgf/number format/verbatim(style, no value) ¶
A style which configures the number printer to produce verbatim text output, i.e., it doesn’t contain TeX macros.
The style resets 1000 sep, dec sep, print sign, skip 0. and sets assume math mode. Furthermore, it installs a sci generic format for verbatim output of scientific numbers.
However, it will still respect precision, fixed zerofill, sci zerofill and the overall styles fixed, sci, int detect (and their variants). It might be useful if you intend to write output files.