Console#

class astropy.units.format.Console(*args, **kwargs)[source]#

Bases: Base

Output-only format for to display pretty formatting at the console.

For example:

>>> import astropy.units as u
>>> print(u.Ry.decompose().to_string('console'))  
2.1798721*10^-18 m^2 kg s^-2
>>> print(u.Ry.decompose().to_string('console', fraction='multiline'))  
                 m^2 kg
2.1798721*10^-18 ------
                  s^2
>>> print(u.Ry.decompose().to_string('console', fraction='inline'))  
2.1798721*10^-18 m^2 kg / s^2

Attributes Summary

name

Methods Summary

format_exponential_notation(val[, format_spec])

Formats a value in exponential notation.

to_string(unit[, fraction])

Convert a unit to its string representation.

Attributes Documentation

name = 'console'#

Methods Documentation

classmethod format_exponential_notation(val, format_spec='.8g')[source]#

Formats a value in exponential notation.

Parameters:
valnumber

The value to be formatted

format_specstr, optional

Format used to split up mantissa and exponent

Returns:
str

The value in exponential notation in a this class’s format.

classmethod to_string(unit, fraction=False)[source]#

Convert a unit to its string representation.

Implementation for to_string.

Parameters:
unitUnitBase

The unit to convert.

fraction{False|True|’inline’|’multiline’}, optional

Options are as follows:

  • False : display unit bases with negative powers as they are (e.g., km s-1);

  • ‘inline’ or True : use a single-line fraction (e.g., km / s);

  • ‘multiline’ : use a multiline fraction (available for the latex, console and unicode formats only; e.g., $\mathrm{\frac{km}{s}}$).

Raises:
ValueError

If fraction is not recognized.