Application-level settings

General settings at application-level

fractalshades.settings.enable_multithreading: bool = True

Turn on or off multithreading (for debugging purpose)

fractalshades.settings.skip_calc: bool = False

If True, no calculation “loop” will be performed. Only the data already calculated will be post-processed

fractalshades.settings.newton_zoom_level: float = 1e-05

Minimal zoom level for activating Newton search. For shallower zoom, a fixed critical point will be used (usually 0.)

fractalshades.settings.no_newton: bool = False

Veto all Newton iterations- keep the ref point as is for the full precision iterations (usually the center of the image). Useful when the center coordinates of a deep zoom are already known.

fractalshades.settings.inspect_calc: bool = False

Outputs a synthesis report file of the calculation done by tiles. Useful for debugging

fractalshades.settings.chunk_size: int = 200

The size for the basic calculation tile is chunk_size x chunk_size

fractalshades.settings.verbosity: int = 2

Controls the verbosity for the log messages:

  • 0: WARNING & higher severity, output to stdout

  • 1: INFO & higher severity, output to stdout

  • 2 (default):

    • INFO & higher severity, output to stdout

    • DEBUG & higher severity, output to a log file

  • 3 (highest verbosity):

    • INFO & higher severity, output to stdout

    • ALL message (incl. NOTSET), output to a log file

Note: Severities in descending order: CRITICAL, ERROR, WARNING, INFO, DEBUG, NOTSET

fractalshades.settings.postproc_dtype: str = 'float32'

The float datatype used for post-processing (“float32” | “float64”).

For the vast majority of output images, the default “float32” should be enough. However, for image with very high iteration number (usually several millions of iterations) banding may occur when plotting the continuous iteration numbers - as the resolution of float32 format is hit. In this case, the solution is to switch to “float64”.

fractalshades.settings.log_directory: str = None

The logging directory for this session - as str

fractalshades.settings.disable_decompression_size_check()[source]

PIL sets a default output limit to 89478485 pixels (1024 * 1024 * 1024 // 4 // 3) and will raise a DecompressionBombWarning if it is exceeded, and a DecompressionBombError for images that are twice this size.

This function removes this check, use at your own risk. It will not be made accessible from the GUI and shall be used in batch mode.

fractalshades.settings.BLA_compression: int = 3

Number of BLA levels which are dropped (not stored)

fractalshades.settings.GUI_image_Mblimit = 0

Maximal size of image that will be displayed in the GUI, in Mb - use 0 for no limit (default). If limit exceeded, the image is still written to disk but will not be interactively displayed in the GUI