Ssht
1.3.3
Fast and exact spin spherical harmonic transforms
|
#include "ssht_types.h"
Go to the source code of this file.
void ssht_core_dh_forward_sov | ( | ssht_complex_double * | flm, |
const ssht_complex_double * | f, | ||
int | L, | ||
int | spin, | ||
int | verbosity | ||
) |
Compute forward transform using Driscoll and Healy quadrature with separation of variables.
[out] | flm | Harmonic coefficients. |
[in] | f | Function on sphere. |
[in] | L | Harmonic band-limit. |
[in] | spin | Spin number. |
[in] | verbosity | Verbosity flag in range [0,5]. |
none |
void ssht_core_dh_forward_sov_real | ( | ssht_complex_double * | flm, |
const double * | f, | ||
int | L, | ||
int | verbosity | ||
) |
Compute forward transform of real scalar signal using Driscoll and Healy quadrature with separation of variables (symmetries for real signals are exploited).
[out] | flm | Harmonic coefficients. |
[in] | f | Function on sphere. |
[in] | L | Harmonic band-limit. |
[in] | spin | Spin number. |
[in] | verbosity | Verbosity flag in range [0,5]. |
none |
void ssht_core_dh_inverse_sov | ( | ssht_complex_double * | f, |
const ssht_complex_double * | flm, | ||
int | L, | ||
int | spin, | ||
int | verbosity | ||
) |
Compute inverse transform using direct method with separation of variables for DH sampling.
[out] | f | Function on sphere. |
[in] | flm | Harmonic coefficients. |
[in] | L | Harmonic band-limit. |
[in] | spin | Spin number. |
[in] | verbosity | Verbosity flag in range [0,5]. |
none |
void ssht_core_dh_inverse_sov_real | ( | double * | f, |
const ssht_complex_double * | flm, | ||
int | L, | ||
int | verbosity | ||
) |
Compute inverse transform of real scalar signal using direct method with separation of variables for DH sampling (symmetries for real signals are exploited).
[out] | f | Function on sphere. |
[in] | flm | Harmonic coefficients. |
[in] | L | Harmonic band-limit. |
[in] | spin | Spin number. |
[in] | verbosity | Verbosity flag in range [0,5]. |
none |
void ssht_core_gl_forward_sov | ( | ssht_complex_double * | flm, |
const ssht_complex_double * | f, | ||
int | L, | ||
int | spin, | ||
int | verbosity | ||
) |
Compute forward transform using Gauss-Legendgre quadrature with separation of variables.
[out] | flm | Harmonic coefficients. |
[in] | f | Function on sphere. |
[in] | L | Harmonic band-limit. |
[in] | spin | Spin number. |
[in] | verbosity | Verbosity flag in range [0,5]. |
none |
void ssht_core_gl_forward_sov_real | ( | ssht_complex_double * | flm, |
const double * | f, | ||
int | L, | ||
int | verbosity | ||
) |
Compute forward transform of real scalar signal using Gauss-Legendgre quadrature with separation of variables (symmetries for real signals are exploited).
[out] | flm | Harmonic coefficients. |
[in] | f | Function on sphere. |
[in] | L | Harmonic band-limit. |
[in] | spin | Spin number. |
[in] | verbosity | Verbosity flag in range [0,5]. |
none |
void ssht_core_gl_inverse_sov | ( | ssht_complex_double * | f, |
const ssht_complex_double * | flm, | ||
int | L, | ||
int | spin, | ||
int | verbosity | ||
) |
Compute inverse transform using direct method with separation of variables for GL sampling.
[out] | f | Function on sphere. |
[in] | flm | Harmonic coefficients. |
[in] | L | Harmonic band-limit. |
[in] | spin | Spin number. |
[in] | verbosity | Verbosity flag in range [0,5]. |
none |
void ssht_core_gl_inverse_sov_real | ( | double * | f, |
const ssht_complex_double * | flm, | ||
int | L, | ||
int | verbosity | ||
) |
Compute inverse transform of real scalar signal using direct method with separation of variables for GL sampling (symmetries for real signals are exploited).
[out] | f | Function on sphere. |
[in] | flm | Harmonic coefficients. |
[in] | L | Harmonic band-limit. |
[in] | spin | Spin number. |
[in] | verbosity | Verbosity flag in range [0,5]. |
none |
void ssht_core_mw_forward_sov_conv_sym | ( | ssht_complex_double * | flm, |
const ssht_complex_double * | f, | ||
int | L, | ||
int | spin, | ||
ssht_dl_method_t | dl_method, | ||
int | verbosity | ||
) |
Compute forward transform for MW method using separation of variables, fast Fourier transforms, performing convolution with weights as product in transformed space and exploiting all symmetries (for complex spin signal).
[out] | flm | Harmonic coefficients. |
[in] | f | Function on sphere. |
[in] | L | Harmonic band-limit. |
[in] | spin | Spin number. |
[in] | dl_method | Method to use when compute Wigner functions. |
[in] | verbosity | Verbosity flag in range [0,5]. |
none |
void ssht_core_mw_forward_sov_conv_sym_pole | ( | ssht_complex_double * | flm, |
const ssht_complex_double * | f, | ||
ssht_complex_double | f_sp, | ||
double | phi_sp, | ||
int | L, | ||
int | spin, | ||
ssht_dl_method_t | dl_method, | ||
int | verbosity | ||
) |
South pole wrapper for forward transform for MW method. The South pole is defined by a single sample and its corresponding phi angle, rather than specifying samples for all phi at the South pole (which are simply related by the rotation of a spin function in its tangent plane).
[out] | flm | Harmonic coefficients. |
[in] | f | Function on sphere (excluding South pole). |
[in] | f_sp | Function sample on South pole. |
[in] | phi_sp | Phi angle corresponding to quoted sample at South pole. |
[in] | L | Harmonic band-limit. |
[in] | spin | Spin number. |
[in] | dl_method | Method to use when compute Wigner functions. |
[in] | verbosity | Verbosity flag in range [0,5]. |
none |
void ssht_core_mw_forward_sov_conv_sym_real | ( | ssht_complex_double * | flm, |
const double * | f, | ||
int | L, | ||
ssht_dl_method_t | dl_method, | ||
int | verbosity | ||
) |
Compute forward transform for MW method of real scalar signal using separation of variables, fast Fourier transforms, performing convolution with weights as product in transformed space and exploiting all symmetries (including additional symmetries for real signals).
[out] | flm | Harmonic coefficients. |
[in] | f | Function on sphere. |
[in] | L | Harmonic band-limit. |
[in] | dl_method | Method to use when compute Wigner functions. |
[in] | verbosity | Verbosity flag in range [0,5]. |
none |
void ssht_core_mw_forward_sov_conv_sym_real_pole | ( | ssht_complex_double * | flm, |
const double * | f, | ||
double | f_sp, | ||
int | L, | ||
ssht_dl_method_t | dl_method, | ||
int | verbosity | ||
) |
South pole wrapper for forward transform of real scalar function for MW method. The South pole is defined by a single sample, rather than specifying samples for all phi at the South pole (which for a scalar function are identical).
[out] | flm | Harmonic coefficients. |
[in] | f | Function on sphere (excluding South pole). |
[in] | f_sp | Function sample on South pole. |
[in] | L | Harmonic band-limit. |
[in] | spin | Spin number. |
[in] | dl_method | Method to use when compute Wigner functions. |
[in] | verbosity | Verbosity flag in range [0,5]. |
none |
void ssht_core_mw_forward_sov_conv_sym_ss | ( | ssht_complex_double * | flm, |
const ssht_complex_double * | f, | ||
int | L, | ||
int | spin, | ||
ssht_dl_method_t | dl_method, | ||
int | verbosity | ||
) |
Compute forward transform for MW method with symmetric sampling using separation of variables, fast Fourier transforms, performing convolution with weights as product in transformed space and exploiting all symmetries (for complex spin signal).
[out] | flm | Harmonic coefficients. |
[in] | f | Function on sphere. |
[in] | L | Harmonic band-limit. |
[in] | spin | Spin number. |
[in] | dl_method | Method to use when compute Wigner functions. |
[in] | verbosity | Verbosity flag in range [0,5]. |
none |
void ssht_core_mw_forward_sov_conv_sym_ss_pole | ( | ssht_complex_double * | flm, |
const ssht_complex_double * | f, | ||
ssht_complex_double | f_np, | ||
double | phi_np, | ||
ssht_complex_double | f_sp, | ||
double | phi_sp, | ||
int | L, | ||
int | spin, | ||
ssht_dl_method_t | dl_method, | ||
int | verbosity | ||
) |
North-South pole wrapper for forward transform for MW method with symmetric sampling. The poles are defined by single samples and their corresponding phi angle, rather than specifying samples for all phi at the poles (which are simply related by the rotation of a spin function in its tangent plane).
[out] | flm | Harmonic coefficients. |
[in] | f | Function on sphere (excluding poles). |
[in] | f_np | Function sample on North pole. |
[in] | phi_np | Phi angle corresponding to quoted sample at North pole. |
[in] | f_sp | Function sample on South pole. |
[in] | phi_sp | Phi angle corresponding to quoted sample at South pole. |
[in] | L | Harmonic band-limit. |
[in] | spin | Spin number. |
[in] | dl_method | Method to use when compute Wigner functions. |
[in] | verbosity | Verbosity flag in range [0,5]. |
none |
void ssht_core_mw_forward_sov_conv_sym_ss_real | ( | ssht_complex_double * | flm, |
const double * | f, | ||
int | L, | ||
ssht_dl_method_t | dl_method, | ||
int | verbosity | ||
) |
Compute forward transform for MW method using symmetric sampling of real scalar signal using separation of variables, fast Fourier transforms, performing convolution with weights as product in transformed space and exploiting all symmetries (including additional symmetries for real signals).
[out] | flm | Harmonic coefficients. |
[in] | f | Function on sphere. |
[in] | L | Harmonic band-limit. |
[in] | dl_method | Method to use when compute Wigner functions. |
[in] | verbosity | Verbosity flag in range [0,5]. |
none |
void ssht_core_mw_forward_sov_conv_sym_ss_real_pole | ( | ssht_complex_double * | flm, |
const double * | f, | ||
double | f_np, | ||
double | f_sp, | ||
int | L, | ||
ssht_dl_method_t | dl_method, | ||
int | verbosity | ||
) |
North-South pole wrapper for forward transform of real scalar function for MW method with symmetric sampling. The poles are defined by single samples, rather than specifying samples for all phi at the poles (which for a scalar function are identical).
[out] | flm | Harmonic coefficients. |
[in] | f | Function on sphere (excluding poles). |
[in] | f_np | Function sample on North pole. |
[in] | f_sp | Function sample on South pole. |
[in] | L | Harmonic band-limit. |
[in] | spin | Spin number. |
[in] | dl_method | Method to use when compute Wigner functions. |
[in] | verbosity | Verbosity flag in range [0,5]. |
none |
void ssht_core_mw_inverse_sov_sym | ( | ssht_complex_double * | f, |
const ssht_complex_double * | flm, | ||
int | L, | ||
int | spin, | ||
ssht_dl_method_t | dl_method, | ||
int | verbosity | ||
) |
Compute inverse transform for MW method using separation of variables, fast Fourier transforms and exploiting all symmetries (for complex spin signal).
[out] | f | Function on sphere. |
[in] | flm | Harmonic coefficients. |
[in] | L | Harmonic band-limit. |
[in] | spin | Spin number. |
[in] | dl_method | Method to use when compute Wigner functions. |
[in] | verbosity | Verbosity flag in range [0,5]. |
none |
void ssht_core_mw_inverse_sov_sym_pole | ( | ssht_complex_double * | f, |
ssht_complex_double * | f_sp, | ||
double * | phi_sp, | ||
const ssht_complex_double * | flm, | ||
int | L, | ||
int | spin, | ||
ssht_dl_method_t | dl_method, | ||
int | verbosity | ||
) |
South pole wrapper for inverse transform for MW method. The South pole is defined by a single sample and its corresponding phi angle, rather than specifying samples for all phi at the South pole (which are simply related by the rotation of a spin function in its tangent plane).
[out] | f | Function on sphere (excluding South pole). |
[out] | f_sp | Function sample on South pole. |
[out] | phi_sp | Phi angle corresponding to quoted sample at South pole. |
[in] | flm | Harmonic coefficients. |
[in] | L | Harmonic band-limit. |
[in] | spin | Spin number. |
[in] | dl_method | Method to use when compute Wigner functions. |
[in] | verbosity | Verbosity flag in range [0,5]. |
none |
void ssht_core_mw_inverse_sov_sym_real | ( | double * | f, |
const ssht_complex_double * | flm, | ||
int | L, | ||
ssht_dl_method_t | dl_method, | ||
int | verbosity | ||
) |
Compute inverse transform for MW method of real scalar signal using separation of variables, fast Fourier transforms and exploiting all symmetries (including additional symmetries for real signals).
[out] | f | Function on sphere. |
[in] | flm | Harmonic coefficients. |
[in] | L | Harmonic band-limit. |
[in] | spin | Spin number. |
[in] | dl_method | Method to use when compute Wigner functions. |
[in] | verbosity | Verbosity flag in range [0,5]. |
none |
void ssht_core_mw_inverse_sov_sym_real_pole | ( | double * | f, |
double * | f_sp, | ||
const ssht_complex_double * | flm, | ||
int | L, | ||
ssht_dl_method_t | dl_method, | ||
int | verbosity | ||
) |
South pole wrapper for inverse transform of real scalar function for MW method. The South pole is defined by a single sample, rather than specifying samples for all phi at the South pole (which for a scalar function are identical).
[out] | f | Function on sphere (excluding South pole). |
[out] | f_sp | Function sample on South pole. |
[in] | flm | Harmonic coefficients. |
[in] | L | Harmonic band-limit. |
[in] | spin | Spin number. |
[in] | dl_method | Method to use when compute Wigner functions. |
[in] | verbosity | Verbosity flag in range [0,5]. |
none |
void ssht_core_mw_inverse_sov_sym_ss | ( | ssht_complex_double * | f, |
const ssht_complex_double * | flm, | ||
int | L, | ||
int | spin, | ||
ssht_dl_method_t | dl_method, | ||
int | verbosity | ||
) |
Compute inverse transform for MW method with symmetric sampling using separation of variables, fast Fourier transforms and exploiting all symmetries (for complex spin signal).
[out] | f | Function on sphere. |
[in] | flm | Harmonic coefficients. |
[in] | L | Harmonic band-limit. |
[in] | spin | Spin number. |
[in] | dl_method | Method to use when compute Wigner functions. |
[in] | verbosity | Verbosity flag in range [0,5]. |
none |
void ssht_core_mw_inverse_sov_sym_ss_pole | ( | ssht_complex_double * | f, |
ssht_complex_double * | f_np, | ||
double * | phi_np, | ||
ssht_complex_double * | f_sp, | ||
double * | phi_sp, | ||
const ssht_complex_double * | flm, | ||
int | L, | ||
int | spin, | ||
ssht_dl_method_t | dl_method, | ||
int | verbosity | ||
) |
North-South pole wrapper for inverse transform for MW method with symmetric sampling. The poles are defined by single samples and their corresponding phi angle, rather than specifying samples for all phi at the poles (which are simply related by the rotation of a spin function in its tangent plane).
[out] | f | Function on sphere (excluding poles). |
[out] | f_np | Function sample on North pole. |
[out] | phi_np | Phi angle corresponding to quoted sample at North pole. |
[out] | f_sp | Function sample on South pole. |
[out] | phi_sp | Phi angle corresponding to quoted sample at South pole. |
[in] | flm | Harmonic coefficients. |
[in] | L | Harmonic band-limit. |
[in] | spin | Spin number. |
[in] | dl_method | Method to use when compute Wigner functions. |
[in] | verbosity | Verbosity flag in range [0,5]. |
none |
void ssht_core_mw_inverse_sov_sym_ss_real | ( | double * | f, |
const ssht_complex_double * | flm, | ||
int | L, | ||
ssht_dl_method_t | dl_method, | ||
int | verbosity | ||
) |
Compute inverse transform for MW method with symmetric sampling of real scalar signal using separation of variables, fast Fourier transforms and exploiting all symmetries (including additional symmetries for real signals).
[out] | f | Function on sphere. |
[in] | flm | Harmonic coefficients. |
[in] | L | Harmonic band-limit. |
[in] | spin | Spin number. |
[in] | dl_method | Method to use when compute Wigner functions. |
[in] | verbosity | Verbosity flag in range [0,5]. |
none |
void ssht_core_mw_inverse_sov_sym_ss_real_pole | ( | double * | f, |
double * | f_np, | ||
double * | f_sp, | ||
const ssht_complex_double * | flm, | ||
int | L, | ||
ssht_dl_method_t | dl_method, | ||
int | verbosity | ||
) |
North-South pole wrapper for inverse transform of real scalar function for MW method with symmetric sampling. The poles are defined by single samples, rather than specifying samples for all phi at the poles (which for a scalar function are identical).
[out] | f | Function on sphere (excluding poles). |
[out] | f_sp | Function sample on South pole. |
[out] | f_np | Function sample on North pole. |
[in] | flm | Harmonic coefficients. |
[in] | L | Harmonic band-limit. |
[in] | spin | Spin number. |
[in] | dl_method | Method to use when compute Wigner functions. |
[in] | verbosity | Verbosity flag in range [0,5]. |
none |
void ssht_core_mw_lb_forward_sov_conv_sym | ( | ssht_complex_double * | flm, |
const ssht_complex_double * | f, | ||
int | L0, | ||
int | L, | ||
int | spin, | ||
ssht_dl_method_t | dl_method, | ||
int | verbosity | ||
) |
Compute forward transform for MW method using separation of variables, fast Fourier transforms, performing convolution with weights as product in transformed space and exploiting all symmetries (for complex spin signal).
[out] | flm | Harmonic coefficients. |
[in] | f | Function on sphere. |
[in] | L0 | Lower harmonic band-limit. |
[in] | L | Upper harmonic band-limit. |
[in] | spin | Spin number. |
[in] | dl_method | Method to use when compute Wigner functions. |
[in] | verbosity | Verbosity flag in range [0,5]. |
none |
void ssht_core_mw_lb_forward_sov_conv_sym_real | ( | ssht_complex_double * | flm, |
const double * | f, | ||
int | L0, | ||
int | L, | ||
ssht_dl_method_t | dl_method, | ||
int | verbosity | ||
) |
Compute forward transform for MW method of real scalar signal using separation of variables, fast Fourier transforms, performing convolution with weights as product in transformed space and exploiting all symmetries (including additional symmetries for real signals).
[out] | flm | Harmonic coefficients. |
[in] | f | Function on sphere. |
[in] | L0 | Lower harmonic band-limit. |
[in] | L | Upper harmonic band-limit. |
[in] | dl_method | Method to use when compute Wigner functions. |
[in] | verbosity | Verbosity flag in range [0,5]. |
none |
void ssht_core_mw_lb_forward_sov_conv_sym_ss | ( | ssht_complex_double * | flm, |
const ssht_complex_double * | f, | ||
int | L0, | ||
int | L, | ||
int | spin, | ||
ssht_dl_method_t | dl_method, | ||
int | verbosity | ||
) |
Compute forward transform for MW method with symmetric sampling using separation of variables, fast Fourier transforms, performing convolution with weights as product in transformed space and exploiting all symmetries (for complex spin signal).
[out] | flm | Harmonic coefficients. |
[in] | f | Function on sphere. |
[in] | L0 | Lower harmonic band-limit. |
[in] | L | Upper harmonic band-limit. |
[in] | spin | Spin number. |
[in] | dl_method | Method to use when compute Wigner functions. |
[in] | verbosity | Verbosity flag in range [0,5]. |
none |
void ssht_core_mw_lb_forward_sov_conv_sym_ss_real | ( | ssht_complex_double * | flm, |
const double * | f, | ||
int | L0, | ||
int | L, | ||
ssht_dl_method_t | dl_method, | ||
int | verbosity | ||
) |
Compute forward transform for MW method using symmetric sampling of real scalar signal using separation of variables, fast Fourier transforms, performing convolution with weights as product in transformed space and exploiting all symmetries (including additional symmetries for real signals).
[out] | flm | Harmonic coefficients. |
[in] | f | Function on sphere. |
[in] | L0 | Lower harmonic band-limit. |
[in] | L | Upper harmonic band-limit. |
[in] | dl_method | Method to use when compute Wigner functions. |
[in] | verbosity | Verbosity flag in range [0,5]. |
none |
void ssht_core_mw_lb_inverse_sov_sym | ( | ssht_complex_double * | f, |
const ssht_complex_double * | flm, | ||
int | L0, | ||
int | L, | ||
int | spin, | ||
ssht_dl_method_t | dl_method, | ||
int | verbosity | ||
) |
Compute inverse transform for MW method using separation of variables, fast Fourier transforms and exploiting all symmetries (for complex spin signal).
[out] | f | Function on sphere. |
[in] | flm | Harmonic coefficients. |
[in] | L0 | Lower harmonic band-limit. |
[in] | L | Upper harmonic band-limit. |
[in] | spin | Spin number. |
[in] | dl_method | Method to use when compute Wigner functions. |
[in] | verbosity | Verbosity flag in range [0,5]. |
none |
void ssht_core_mw_lb_inverse_sov_sym_real | ( | double * | f, |
const ssht_complex_double * | flm, | ||
int | L0, | ||
int | L, | ||
ssht_dl_method_t | dl_method, | ||
int | verbosity | ||
) |
Compute inverse transform for MW method of real scalar signal using separation of variables, fast Fourier transforms and exploiting all symmetries (including additional symmetries for real signals).
[out] | f | Function on sphere. |
[in] | flm | Harmonic coefficients. |
[in] | L0 | Lower harmonic band-limit. |
[in] | L | Upper harmonic band-limit. |
[in] | spin | Spin number. |
[in] | dl_method | Method to use when compute Wigner functions. |
[in] | verbosity | Verbosity flag in range [0,5]. |
none |
void ssht_core_mw_lb_inverse_sov_sym_ss | ( | ssht_complex_double * | f, |
const ssht_complex_double * | flm, | ||
int | L0, | ||
int | L, | ||
int | spin, | ||
ssht_dl_method_t | dl_method, | ||
int | verbosity | ||
) |
Compute inverse transform for MW method with symmetric sampling using separation of variables, fast Fourier transforms and exploiting all symmetries (for complex spin signal).
[out] | f | Function on sphere. |
[in] | flm | Harmonic coefficients. |
[in] | L0 | Lower harmonic band-limit. |
[in] | L | Upper harmonic band-limit. |
[in] | spin | Spin number. |
[in] | dl_method | Method to use when compute Wigner functions. |
[in] | verbosity | Verbosity flag in range [0,5]. |
none |
void ssht_core_mw_lb_inverse_sov_sym_ss_real | ( | double * | f, |
const ssht_complex_double * | flm, | ||
int | L0, | ||
int | L, | ||
ssht_dl_method_t | dl_method, | ||
int | verbosity | ||
) |
Compute inverse transform for MW method with symmetric sampling of real scalar signal using separation of variables, fast Fourier transforms and exploiting all symmetries (including additional symmetries for real signals).
[out] | f | Function on sphere. |
[in] | flm | Harmonic coefficients. |
[in] | L0 | Lower harmonic band-limit. |
[in] | L | Upper harmonic band-limit. |
[in] | spin | Spin number. |
[in] | dl_method | Method to use when compute Wigner functions. |
[in] | verbosity | Verbosity flag in range [0,5]. |
none |
void ssht_core_mwdirect_inverse | ( | ssht_complex_double * | f, |
const ssht_complex_double * | flm, | ||
int | L, | ||
int | spin, | ||
int | verbosity | ||
) |
Compute inverse transform using direct method for MW sampling.
[out] | f | Function on sphere. |
[in] | flm | Harmonic coefficients. |
[in] | L | Harmonic band-limit. |
[in] | spin | Spin number. |
[in] | verbosity | Verbosity flag in range [0,5]. |
none |
void ssht_core_mwdirect_inverse_sov | ( | ssht_complex_double * | f, |
const ssht_complex_double * | flm, | ||
int | L, | ||
int | spin, | ||
int | verbosity | ||
) |
Compute inverse transform using direct method with separation of variables for MW sampling.
[out] | f | Function on sphere. |
[in] | flm | Harmonic coefficients. |
[in] | L | Harmonic band-limit. |
[in] | spin | Spin number. |
[in] | verbosity | Verbosity flag in range [0,5]. |
none |
void ssht_core_mwdirect_inverse_ss | ( | ssht_complex_double * | f, |
const ssht_complex_double * | flm, | ||
int | L, | ||
int | spin, | ||
int | verbosity | ||
) |
Compute inverse transform using direct method for MW symmetric sampling.
[out] | f | Function on sphere. |
[in] | flm | Harmonic coefficients. |
[in] | L | Harmonic band-limit. |
[in] | spin | Spin number. |
[in] | verbosity | Verbosity flag in range [0,5]. |
none |