---
title: "Simulated Grouped Hyper Data Frame"
author: Tingting Zhan
date: today
format: 
  html:
    page-layout: full
    html-math-method: katex
    link-external-icon: true
    link-external-newwindow: true
number-sections: true
toc: true
toc-location: left
toc-depth: 4
toc-title: ''
editor: source
bibliography: groupedHyperframe.random.bib
knitr:
  opts_chunk: 
    collapse: true
    comment: "#" 
vignette: >
  %\VignetteIndexEntry{intro}
  %\VignetteEngine{quarto::html}
  %\VignetteEncoding{UTF-8}
---

# Introduction

The complete vignette of R package **`groupedHyperframe.random`** (v`r packageVersion('groupedHyperframe.random')`) 

> <https://rpubs.com/tingtingzhan/groupedHyperframe_random>

documents

-   the simulation of superimposed (marked) point-pattern objects via *vectorized parameterization*;
-   the simulation of grouped hyper data frame via *matrix parameterization*.

The complete vignette exceeds the file size limit allowed on [CRAN](https://cran.r-project.org/package=groupedHyperframe.random).  


# Prerequisite

## Environment

Package **`groupedHyperframe.random`** (v`r packageVersion('groupedHyperframe.random')`) requires R version 4.5.0 (released 2025-04-11) or higher ([macOS](https://cran.r-project.org/bin/macosx/), [Windows](https://cran.r-project.org/bin/windows/base/), [Linux](https://cran.r-project.org/bin/linux/)).

An Integrated Development Environment (IDE), e.g., [RStudio](https://posit.co/download/rstudio-desktop/) [@RStudio] or [Positron](https://positron.posit.co/download.html), is not required, but highly recommended.


```{r}
#| code-fold: true
#| code-summary: "Environment on author's computer"
#| label: author-env
Sys.info()[c('sysname', 'release', 'machine')]
R.version
```



## Enhancement & Dependency

Package **`groupedHyperframe.random`** (v`r packageVersion('groupedHyperframe.random')`) `Enhances` the **`spatstat.*`** family of packages [@spatstat15; @spatstat05], especially **`spatstat.random`**. Details are provided in the [complete vignette](https://rpubs.com/tingtingzhan/groupedHyperframe_random), Section 4.1.


The dependencies of package **`groupedHyperframe.random`** are detailed in the [complete vignette](https://rpubs.com/tingtingzhan/groupedHyperframe_random), Section 4.1. 


Package **`groupedHyperframe.random`** requires the *development versions* of the **`spatstat.*`** family of packages. Installation instructions are provided in the [complete vignette](https://rpubs.com/tingtingzhan/groupedHyperframe) of package **`groupedHyperframe`** [@groupedHyperframe, v`r packageVersion('groupedHyperframe')`], Section 4.1. 




## Installation

Packages **`groupedHyperframe.random`** (v`r packageVersion('groupedHyperframe.random')`) and **`groupedHyperframe`** (v`r packageVersion('groupedHyperframe')`) can be installed using the following command.


```{r}
#| eval: false
utils::install.packages('groupedHyperframe')
utils::install.packages('groupedHyperframe.random')
```

## Getting Started

Examples in this vignette require that the `search` path has

```{r}
library(groupedHyperframe.random)
```

```{r}
#| echo: false
#options(mc.cores = 1L) # for CRAN submission
```

## Acknowledgement

This work is supported by National Institutes of Health, U.S. Department of Health and Human Services grants

-   R01CA222847 ([I. Chervoneva](https://orcid.org/0000-0002-9104-4505), [T. Zhan](https://orcid.org/0000-0001-9971-4844), and [H. Rui](https://orcid.org/0000-0002-8778-261X))
-   R01CA253977 (H. Rui and I. Chervoneva).




# References {.appendix}

::: {#refs}
:::