Slovník | Vyhledávání | Mapa webu
 
Základy informatiky pro biologyCvičebnice jazyka R Dokumentace k základním funkcím as.data.frame

as.data.frame

Vnucení do datového rámce

as.data.frame {base} Dokumentace R v češtině

Popis

Funkce, která zjistí, zda je objekt datový rámec. Pokud není a je-li to možné, převede jej.

Použití

as.data.frame(x, row.names = NULL, optional = FALSE, ...)

## S3 metoda pro třídu 'řetězec'
as.data.frame(x, ...,
stringsAsFactors = default.stringsAsFactors())

## S3 metoda pro třídu 'seznam'
as.data.frame(x, row.names = NULL, optional = FALSE, ...,
cut.names = FALSE, col.names = names(x), fix.empty.names = TRUE,
stringsAsFactors = default.stringsAsFactors())

## S3 metoda pro třídu 'matice'
as.data.frame(x, row.names = NULL, optional = FALSE,
make.names = TRUE, ...,
stringsAsFactors = default.stringsAsFactors())

is.data.frame(x)

Argumenty

x

jakýkoliv R objekt.
row.names

NULL nebo znakový vektor, který udává názvy řádků pro datový rámec. Chybějící hodnoty nejsou povoleny.
optional

logická proměnná. Pokud je TRUE, nastavení názvů řádků a konverze názvů sloupců (do syntaxově správných názvů: viz make.names) je volitelné. Je třeba zmínit, že metody as.data.frame() ve všech R'kových base balících používají optional pouze pro úpravu názvů sloupců, zejména ve významu data.frame(*, check.names = !optional). Viz také make.names argument v metodě matrix.
...

Doplňující argumenty, které můžou vložit nebo vzít z metod.
stringsAsFactors

logická proměnná: má být znakový vektor převeden na faktorový?
cut.names

logická nebo číselná proměnná; značí jestli názvy sloupců s více než 256 (nebo cut.names pokud jsou číselné) znaky mají být zkráceny (a posledních 6 znaků nahrazeno " ...").
col.names

(volitelné) znakový vektor názvů sloupců.
fix.empty.names

logická proměnná, která značí, zda prázdné názvy sloupců, jako např., "" mají být zachovány (in data.frame) či nikoliv.
make.names

logická proměnná, která nabývá jeden z následujícíh výrazů: FALSE, NA, TRUE, a značí, co se má stát pokud názvy řádků (v matici x) jsou neplatné. Jsou-li neplatné, předem nastavený výraz, TRUE, použije make.names(*, unique=TRUE); make.names=NA použije “automatické” názvy řádků a v případě výrazu FALSE bude hlášena chyba pro neplatné názvy řádků.

Detaily

as.data.frame je generická funkce použitelná v mnoha metodách. Uživatelé a balíky mohou poskytnout další metody. as.data.frame.vector bude fungovat jako metoda pro třídy typu vektorů.

V případě seznamu bude každý prvek převeden na sloupec v datovém rámci. Podobně bude zvlášť převeden každý sloupec matice. Toto nemusí platit v případě, že objekt patří do třídy, která má metodu pro as.data.frame: dvěma příklady jsou matice třídy "model.matrix" (které jsou zahrnuty jako jeden sloupec) a seznam objektů třídy "POSIXlt" které jsou vnuceny do třídy "POSIXct".

Pole mohou být převedena na datové rámce. Jednorozměrná pole jsou považována za vektory, dvojrozměrná za matice. Pole s více než dvěma dimenzemi jsou převedena na matice nejdříve pomocí "oploštění" a následně vytvořením vhodného označení sloupců.

Znakové proměnné jsou převedeny do faktorových sloupců pokud nejsou chráněné I.

Pokud je poskytnut datový rámec, všechny třídy, které předcházely "data.frame" jsou stripped, a názvy řádků jsou změněny, pokud je poskytnutý příslušný argument.

Pokud row.names = NULLI, tak jsou názvy ze sloupcového vektoru odstraněny.

Hodnoty

as.data.frame vrátí datový rámec, běžně s názvy všech řádků jako "", pokud optional = TRUE.

is.data.frame vrátí výraz TRUE pokud jeho argument je datový rámec (to znamená, že má "data.frame" mezi svými třídami). V opačném případě vrátí výraz FALSE.

Reference

Chambers, J. M. (1992) Data for models. Kapitola 3 v Statistical Models in S eds J. M. Chambers and T. J. Hastie, Wadsworth & Brooks/Cole.

Viz také

data.frame, as.data.frame.table pro metodu table (která má doplňující argumenty, je-li použita přímo).

 
vytvořil Institut biostatistiky a analýz Lékařské fakulty Masarykovy univerzity