Przejdź do treści
Biblioteka skilli
Dane i analityka · Analiza

sample-correlation-analysis

/sample-correlation-analysis

Wykonuje analizę korelacji Pearsona i Spearmana między dwiema zmiennymi, z parametrami z wiersza poleceń, wykrywaniem formatu danych, walidacją i eksportem wyników do CSV lub TXT.

Licencja
MIT
Ostatnia zmiana repozytorium
17.09.2026

Ocena i bezpieczeństwo

100/ 100Klasa: dobry
Format25 / 25
Frontmatter z nazwą i opisem, poprawna nazwa, opis do 1024 znaków, nazwa zgodna z folderem.
Odkrywalność25 / 25
Opis mówi, kiedy użyć skilla, ma sensowną długość i jest w 3. osobie.
Treść35 / 35
Co najmniej 150 słów i do 500 linii, nagłówki, listy kroków, przykłady albo kod.
Higiena15 / 15
Bez zaślepek typu TODO, bez ścieżek Windows, z licencją.
Ryzykobrak sygnałów w skanie
Pliki w paczce
12
Skrypty
0
Komentarze HTML
0
Adresy URL w SKILL.md
3
Przestarzałość

Brak sygnałów. Repozytorium zmienione 17.09.2026, bez odwołań do wycofanych modeli i API.

Licencja

MIT, otwarta: można używać i zmieniać, z zachowaniem informacji o autorze.

Co robi i kiedy

Wykonuje analizę korelacji Pearsona i Spearmana między dwiema zmiennymi, z parametrami z wiersza poleceń, wykrywaniem formatu danych, walidacją i eksportem wyników do CSV lub TXT.

Oryginalny opis (EN)

Use when performing correlation analysis between two variables including Pearson and Spearman correlation methods. Supports command-line parameter input, automatic data format detection, parameter validation, result directory creation, and CSV or TXT format result export.

Jak działa

  1. Use This Skill When
  2. Primary Command
  3. Prerequisites
  4. Core Arguments
  5. Input Requirements
  6. Minimal Workflow
  7. Outputs
  8. Choose the Method
  9. Read These Files When Needed
  10. Quick Examples
Sekcje z nagłówków SKILL.md, w oryginale · 164 linii, 631 słów
Podgląd SKILL.md
---
name: sample-correlation-analysis
description: Use when performing correlation analysis between two variables including Pearson and Spearman correlation methods. Supports command-line parameter input, automatic data format detection, parameter validation, result directory creation, and CSV or TXT format result export.
license: MIT
author: AIPOCH
---
> **Source**: [https://github.com/aipoch/medical-research-skills](https://github.com/aipoch/medical-research-skills)

# Correlation Analysis

Use this skill to run correlation analysis on two variables from a tabular data file.

## Use This Skill When

- You need Pearson or Spearman correlation between two variables stored either as columns or as first-column row labels.
- You need a command-line workflow with parameter validation.
- You need standardized output files in CSV or TXT format.

## Primary Command

```bash
Rscript scripts/main.R \
  --data_file <input_file> \
  --method <pearson|spearman> \
  --x_var <variable_name> \
  --y_var <variable_name> \
  --output_dir <output_dir>
```

## Prerequisites

- Rscript is available in the shell.
- Required R packages: `optparse`, `data.table`.
- Install missing packages with `Rscript -e 'install.packages(c("optparse", "data.table"), repos="https://cloud.r-project.org")'`.

## Core Arguments

| Argument | Required | Description |
|----------|----------|-------------|
| `--data_file` | Yes | Input data file in CSV, TXT, or TSV format |
| `--method` | No | Correlation method: `pearson` or `spearman`. Default `pearson` |
| `--x_var` | No | First variable name. It can match a column name or a first-column row label. Default `variable1` |
| `--y_var` | No | Second variable name. It can match a column name or a first-column row label. Default `variable2` |
| `--output_dir` | No | Output directory, default `./Correlation_Results` |
| `--alternative` | No | `two.sided`, `less`, or `greater`. Default `two.sided` |
| `--conf_level` | No | Confidence level between 0 and 1, default `0.95` |
| `--output_format` | No | `csv` or `txt`, default `csv` |
| `--output_prefix` | No | Output filename prefix, default `correlation` |

## Input Requirements

- The input file must contain both target variables.
- Both variables must contain numeric values.
- If the first column stores variable names and the remaining columns are samples, the script automatically reads variables by row label.
- Rows with missing values in either variable are excluded.
- At least 3 complete observation pairs are needed.

Example input:

```csv
variable1,variable2
10.2,8.5
11.5,9.2
9.8,7.9
```

## Minimal Workflow

1. Confirm the input file exists and variable names are correct.
2. Run `scripts/main.R` with the requested method and variable names.
3. Check the output directory for result files under `table/`.

If you omit `--data_file`, the script exits with `SKILL_MISSING_INPUT`.

## Outputs

Expected output structure:

```text
<output_dir>/
├── table/
├── figure/
└── data/
```

Primary result file:

- `table/<output_prefix>_<method>.csv`
- `table/<output_prefix>_<method>.txt`

Result fields include:

- `method`
- `correlation`
- `statistic`
- `p_value`
- `conf_low`
- `conf_high`
- `sample_size`
- `x_variable`
- `y_variable`
- `variable_orientation`

## Choose the Method

- Use `pearson` for linear relationships between continuous variables.
- Use `spearman` for monotonic relationships, non-normal data, or outlier-prone data.

## Read These Files When Needed

| Need | File |
|------|------|
| Statistical details and assumptions | `references/algorithm.md` |
| More CLI examples | `references/cli-guide.md` |
| Error diagnosis | `references/troubleshooting.md` |
| Main execution entry point | `scripts/main.R` |
| Sample test data | `tests/data/` |

## Quick Examples

Pearson:

```bash
Rscript scripts/main.R \
  --data_file tests/data/sample_correlation_1.csv \
  --method pearson \
  --x_var variable1 \
  --y_var variable2 \
  --output_dir tests/output_pearson
```

Spearman:

```bash
Rscript scripts/main.R \
  --data_file tests/data/sample_correlation_3.csv \
  --method spearman \
  --x_var "Activated CD8 T cell" \
  --y_var "Central memory CD8 T cell" \
  --output_dir tests/output_spearman
```

## Validation

```bash
Rscript scripts/main.R --help
```

```bash
Rscript scripts/main.R \
  --data_file tests/data/sample_correlation_1.csv \
  --method pearson \
  --x_var variable1 \
  --y_var variable2 \
  --output_dir tests/validation_output
```

After running analysis, verify that `tests/validation_output/table/correlation_pearson.csv` exists.

## Common Errors

- `SKILL_FILE_NOT_FOUND`: Input file path is wrong or inaccessible.
- `SKILL_MISSING_COLUMNS`: One or both requested variables are missing.
- `SKILL_INVALID_DATA`: Input data is malformed or unsuitable for analysis.
- `SKILL_INVALID_PARAMETER`: An argument value is invalid.
- `SKILL_INSUFFICIENT_DATA`: Too few complete observations remain after filtering.
- `SKILL_DEPENDENCY_MISSING`: A required R package such as `optparse` or `data.table` is unavailable.

If the issue is not obvious, read `references/troubleshooting.md`.
Pliki w paczce (12)
  • SKILL.md 5 KB
  • eval_report_sample-correlation-analysis_result.json 16 KB
  • references/algorithm.md 6 KB
  • references/cli-guide.md 7 KB
  • references/troubleshooting.md 8 KB
  • scripts/functions.R 4 KB
  • scripts/main.R 3 KB
  • scripts/run_analysis.R 3 KB
  • scripts/utils.R 3 KB
  • tests/data/sample_correlation_1.csv 1 KB
  • tests/data/sample_correlation_2.csv 69 KB
  • tests/data/sample_correlation_3.csv 6 KB

Wersje

W bazie nie ma innych skilli o nazwie sample-correlation-analysis.

Migawka bazy z 13.11.2026 · wersja paczki 8f39a2a5e1d4 (skrót SHA-256 całej paczki)

Pobrania w ostatnich 30 dniach: 0 · ranking

Zgłoś problem z tym skillem: szkodliwa treść, błędny opis albo prośba autora o usunięcie.

Podobne skille

  • 100pca-dimensionality-reduction
    Redukuje wymiarowość tabelarycznych danych liczbowych analizą PCA z parametrami z wiersza poleceń, automatycznym wyborem cech i eksportem wyników do CSV lub TXT.
  • 100correlation-auditor
    Analizuje macierze korelacji Pearsona i Spearmana, liczy korelacje cząstkowe z kontrolą zmiennych zakłócających i wskazuje potencjalne korelacje pozorne.
  • 90correlation-analysis
    Wylicza korelacje między zmiennymi liczbowymi w pliku CSV, Parquet lub Excel, wskazując najmocniejsze pary dodatnie i ujemne.
  • 100corr-insight
    Oblicza macierze korelacji Pearsona i Spearmana oraz analizę korelacji cząstkowej i automatycznie wykrywa pozorne korelacje wynikające ze zmiennych zakłócających.
  • 100correlation-analyzer
    Prawdopodobnie analizuje korelacje w danych w ramach analityki danych.
  • 100km-survival-curve
    Generuje krzywe przeżycia Kaplana-Meiera z danych tabelarycznych z czasem, statusem zdarzenia i grupą ryzyka, z parametrami z wiersza poleceń, walidacją i eksportem PDF.

Uwagi i zgłoszenia

Wiadomość trafi do Bartosza Sokolińskiego. Adres e-mail jest potrzebny tylko do odpowiedzi. Szczegóły w polityce prywatności.