# GGIR

> Code corresponding to R package GGIR

**Wikidata**: [Q120925235](https://www.wikidata.org/wiki/Q120925235)  
**Source**: https://4ort.xyz/entity/ggir

## Summary
GGIR is an open-source R package designed to generate physical activity and sleep outcomes from multi-day raw accelerometer data. It is free software licensed under the Apache Software License 2.0, allowing users to study, modify, and distribute the code. The package serves as a research community–driven tool for processing complex wearable data.

## Key Facts
- **Entity Type:** Free software / R package.
- **Primary Function:** Generates physical activity and sleep outcomes from multi-day raw accelerometer data.
- **License:** Apache Software License 2.0.
- **Official Website:** [CRAN GGIR Package Index](https://cran.r-project.org/web/packages/GGIR/index.html)
- **Source Code Repository:** [github.com/wadpac/GGIR](https://github.com/wadpac/GGIR)
- **Download URL:** [github.com/wadpac/GGIR/releases](https://github.com/wadpac/GGIR/releases)
- **Descriptive Source:** Titled "GGIR: A Research Community–Driven Open Source R Package for Generating Physical Activity and Sleep Outcomes From Multi-Day Raw Accelerometer Data."

## FAQs
### Q: What is the primary purpose of the GGIR package?
A: GGIR is used to process multi-day raw accelerometer data to generate actionable insights regarding physical activity and sleep patterns. It provides a computational workflow for researchers handling wearable sensor data.

### Q: Under what license is GGIR distributed?
A: GGIR is distributed as free software under the Apache Software License 2.0. This allows users to freely run, study, change, and distribute the software and its modified versions.

### Q: Where can the source code for GGIR be accessed?
A: The source code is maintained in a public repository located at `github.com/wadpac/GGIR`. Stable releases can be downloaded from the associated releases page.

## Why It Matters
GGIR holds significant importance in the field of digital health and epidemiology as a specialized tool for analyzing raw accelerometer data. As wearable technology becomes ubiquitous in research, the volume of raw data generated poses a significant processing challenge. GGIR addresses this by offering a standardized, validated method for converting raw acceleration signals into meaningful health metrics, specifically concerning physical activity and sleep.

Because it is an open-source project driven by the research community, GGIR promotes transparency and reproducibility in scientific studies. Unlike proprietary "black box" algorithms often used in consumer wearables, GGIR allows researchers to inspect the code and understand exactly how metrics like sleep duration or activity intensity are calculated. This openness fosters collaboration and allows the software to evolve based on the specific needs of the scientific community, ensuring that it remains relevant as sensor technology advances. Its availability as an R package on CRAN further ensures that it is easily accessible to data scientists and statisticians worldwide.

## Notable For
- Being a **research community–driven** initiative, ensuring its algorithms reflect current scientific consensus.
- Providing an **open-source alternative** to proprietary accelerometer data processing software.
- Processing **multi-day raw accelerometer data**, a complex data type requiring specialized handling.
- dual utility in analyzing both **physical activity and sleep** outcomes within a single package.
- Distribution via **CRAN** (Comprehensive R Archive Network), ensuring standard compliance with the R programming environment.

## Body
### Software Classification
GGIR is classified as free software and functions as a package within the R programming environment. As free software, it is distributed under terms that grant users the freedom to run, study, change, and distribute it and any modified versions. The specific legal framework governing its use is the Apache Software License 2.0.

### Functionality and Scope
The package is explicitly designed to handle raw accelerometer data collected over multiple days. Its core capability involves processing this raw input to generate specific health-related outcomes.
*   **Input:** Multi-day raw accelerometer data.
*   **Output:** Physical activity metrics and sleep outcomes.

According to its primary descriptive source, "GGIR: A Research Community–Driven Open Source R Package for Generating Physical Activity and Sleep Outcomes From Multi-Day Raw Accelerometer Data," the tool is a product of collaborative development efforts within the research community.

### Availability and Resources
GGIR is accessible through several key digital channels:
*   **CRAN:** The official package index is hosted on the Comprehensive R Archive Network at `https://cran.r-project.org/web/packages/GGIR/index.html`.
*   **Source Code:** Development and source code are hosted on GitHub at `https://github.com/wadpac/GGIR`.
*   **Downloads:** Specific software releases are available for download via the GitHub releases page at `https://github.com/wadpac/GGIR/releases`.

## References

1. [Source](https://api.github.com/repos/wadpac/GGIR)