get_memory_thresholds

get_memory_thresholds

SYSTEM_UTILS

1 Description

Calculates appropriate memory thresholds for conversions based on total system RAM. Returns conservative values suitable for most systems.

2 Usage

get_memory_thresholds(total_ram = NULL)

3 Arguments

Parameter	Description
`total_ram`	Numeric. Total system RAM in GB. If NULL (default), auto-detects using C++ implementation.

4 Value

Named list with thresholds in MB:

silent: Size below which conversions happen silently
warning: Size requiring user confirmation
force: Size requiring force=TRUE
blocked: Size that cannot be converted

5 Details

Calculation logic:

Uses percentage of total RAM with safety margins:

Fallback values (if RAM detection fails):

6 Examples

\donttest{
# Auto-detect
thresholds <- get_memory_thresholds()
# $silent: 3000 MB, $warning: 8000 MB, etc.

# Manual specification (e.g., for 32GB system)
thresholds <- get_memory_thresholds(total_ram = 32)
}

7 See Also

get_total_ram, memory_info

---
title: "get_memory_thresholds"
subtitle: "get_memory_thresholds"
---

<span class="category-badge system_utils">SYSTEM_UTILS</span>

## Description

Calculates appropriate memory thresholds for conversions based on
total system RAM. Returns conservative values suitable for most systems.

## Usage

```r
get_memory_thresholds(total_ram = NULL)
```
## Arguments

::: {.param-table}
| Parameter | Description |
|-----------|-------------|
| `total_ram` | Numeric. Total system RAM in GB. If NULL (default),   auto-detects using C++ implementation.  |
:::

## Value

::: {.return-value}
Named list with thresholds in MB:


- **`silent`**: Size below which conversions happen silently
- **`warning`**: Size requiring user confirmation
- **`force`**: Size requiring force=TRUE
- **`blocked`**: Size that cannot be converted

:::
## Details

**Calculation logic:**

Uses percentage of total RAM with safety margins:
\itemize{
  \item Silent: 15\% of RAM (up to 3GB max)
  \item Warning: 30\% of RAM (up to 8GB max)
  \item Force: 50\% of RAM (up to 16GB max)
  \item Blocked: 80\% of RAM (hard limit)
}

**Fallback values** (if RAM detection fails):
\itemize{
  \item Silent: 2 GB
  \item Warning: 4 GB
  \item Force: 8 GB
  \item Blocked: 16 GB
}

## Examples
```{r}
#| eval: false
#| warning: false

\donttest{
# Auto-detect
thresholds <- get_memory_thresholds()
# $silent: 3000 MB, $warning: 8000 MB, etc.

# Manual specification (e.g., for 32GB system)
thresholds <- get_memory_thresholds(total_ram = 32)
}

```
## See Also

::: {.see-also}
[get_total_ram](get_total_ram.html), [memory_info](memory_info.html)

:::