kwave.utils.checks module¶
- check_divisible(number, divider)[source]¶
Checks whether number is divisible by divider without any remainder Why do we need such a function? -> Because due to floating point precision we experience rounding errors while using standard modulo operator with floating point numbers
- Parameters:
number (float) – Number that’s supposed to be divided
divider (float) – Divider that should devide the number
- Returns:
True if number is divisible by divider, False otherwise
- Return type:
bool
- check_factors(min_number, max_number)[source]¶
Return the maximum prime factor for a range of numbers.
checkFactors loops through the given range of numbers and finds the numbers with the smallest maximum prime factors. This allows suitable grid sizes to be selected to maximise the speed of the FFT (this is fastest for FFT lengths with small prime factors). The output is printed to the command line.
- Parameters:
min_number (int) – integer specifying the lower bound of values to test
max_number (int) – integer specifying the upper bound of values to test
- Return type:
None
- check_field_names(dictionary, *fields)[source]¶
This method checks if the keys of the given dictionary are valid fields.
- Parameters:
dictionary – A dictionary where the keys will be checked for validity.
*fields – A list of valid field names.
- Raises:
AssertionError – If any of the keys in the dictionary are not in the list of valid fields.
- check_stability(kgrid, medium)[source]¶
Calculates the maximum time step for which the k-space propagation models are stable.
These models are unconditionally stable when the reference sound speed is equal to or greater than the maximum sound speed in the medium and there is no absorption. However, when the reference sound speed is less than the maximum sound speed the model is only stable for sufficiently small time steps. The criterion is more stringent (the time step is smaller) in the absorbing case.
The time steps given are accurate when the medium properties are homogeneous. For a heterogeneous media they give a useful, but not exact, estimate.
- Parameters:
kgrid (kWaveGrid) – simulation grid
medium (kWaveMedium) – medium properties
- Returns:
The maximum time step for which the models are stable. This is set to Inf when the model is unconditionally stable.
- Return type:
float
- check_str_eq(value, target)[source]¶
This method checks whether the given value is a string and is equal to the target string. It is useful to avoid FutureWarnings when value is not a string.
- Parameters:
value – The value to check.
target (str) – The target string to compare with.
- Returns:
True if the value is a string and is equal to the target, False otherwise.
- Return type:
bool
- check_str_in(value, target)[source]¶
Check if value is in the given list only if the value is string. Helps to avoid FutureWarnings when value is not a string. Added by @Farid
- Parameters:
value – The value to check for inclusion in target
target (List[str]) – A list of strings to check for the presence of value
- Returns:
True if value is a string and is present in target, otherwise False
- Return type:
bool
- enforce_fields(dictionary, *fields)[source]¶
Ensures that the given dictionary contains the specified fields.
- Parameters:
dictionary – A dictionary to check.
*fields – The fields that must be present in the dictionary.
- Raises:
AssertionError – If any of the specified fields are not in the dictionary.
- enforce_fields_obj(obj, *fields)[source]¶
Enforces that certain fields are not None in the given object.
- Parameters:
obj – Object to check the fields of.
*fields – List of field names to check.
- Raises:
AssertionError – If any of the given fields are None in the given object.