bound_range

This function computes the range of numeric values in a vector and adjusts
the bounds to "nice" rounded numbers. Specifically, it rounds the lower
bound downwards (similar to <code><a href="/link/floor()?package=nuggets&version=2.0.1" data-mini-rdoc="nuggets::floor()">floor()</a></code>) and the upper bound upwards (similar
to <code><a href="/link/ceiling()?package=nuggets&version=2.0.1" data-mini-rdoc="nuggets::ceiling()">ceiling()</a></code>) to the specified number of digits. This can be useful when
preparing data ranges for axis labels, plotting, or reporting. The function
returns a numeric vector of length two, containing the adjusted lower and
upper bounds.

A framework for systematic exploration of
association rules (Agrawal et al., 1994, <https://www.vldb.org/conf/1994/P487.PDF>),
contrast patterns (Chen, 2022, <doi:10.48550/arXiv.2209.13556>),
emerging patterns (Dong et al., 1999, <doi:10.1145/312129.312191>),
subgroup discovery (Atzmueller, 2015, <doi:10.1002/widm.1144>),
and conditional correlations (Hájek, 1978, <doi:10.1007/978-3-642-66943-9>).
User-defined functions may also be supplied to guide custom pattern searches.
Supports both crisp (Boolean) and fuzzy data. Generates candidate conditions
expressed as elementary conjunctions, evaluates them on a dataset, and
inspects the induced sub-data for statistical, logical, or structural
properties such as associations, correlations, or contrasts. Includes methods
for visualization of logical structures and supports interactive exploration
through integrated Shiny applications.

Michal Burda

nuggets

Extensible Framework for Data Pattern Exploration

bound_range function

<dl><dt>x</dt>
<dd>A numeric vector to be bounded.</dd>
<dt>digits</dt>
<dd>An integer scalar specifying the number of digits to round the
bounds to. A positive value determines the number of decimal places used.
A negative value rounds to the nearest 10, 100, etc. If <code>digits</code> is
<code>NULL</code>, no rounding is performed and the exact range is returned.</dd>
<dt>na_rm</dt>
<dd>A logical flag indicating whether <code>NA</code> values should be removed
before computing the range. If <code>TRUE</code>, the range is computed from non-<code>NA</code>
values only. If <code>FALSE</code> and <code>x</code> contains any <code>NA</code> values, the function
returns <code>c(NA, NA)</code>.</dd></dl>

Arguments

Author

This function computes the range of numeric values in a vector and adjusts
the bounds to "nice" rounded numbers. Specifically, it rounds the lower
bound downwards (similar to <code><a href='https://rdrr.io/r/base/Round.html'>floor()</a></code>) and the upper bound upwards (similar
to <code><a href='https://rdrr.io/r/base/Round.html'>ceiling()</a></code>) to the specified number of digits. This can be useful when
preparing data ranges for axis labels, plotting, or reporting. The function
returns a numeric vector of length two, containing the adjusted lower and
upper bounds.

Bound a range of numeric values — bound_range

<dl>

<dt>x</dt>
<dd>A numeric vector to be bounded.</dd>


<dt>digits</dt>
<dd>An integer scalar specifying the number of digits to round the
bounds to. A positive value determines the number of decimal places used.
A negative value rounds to the nearest 10, 100, etc. If <code>digits</code> is
<code>NULL</code>, no rounding is performed and the exact range is returned.</dd>


<dt>na_rm</dt>
<dd>A logical flag indicating whether <code>NA</code> values should be removed
before computing the range. If <code>TRUE</code>, the range is computed from non-<code>NA</code>
values only. If <code>FALSE</code> and <code>x</code> contains any <code>NA</code> values, the function
returns <code>c(NA, NA)</code>.</dd>

</dl>

bound_range: Bound a range of numeric values

Description

Usage

Value

Arguments

Author

See Also

Examples