Analyze.RFrame

Core frame types and functions

Documentation

data RFrame k v

In-memory row-oriented frame with columns named by k and values by v

Constructors

RFrame

Fields

• _rframeKeys :: !(Vector k)

  Ordered vector of column names

• _rframeLookup :: !(HashMap k Int)

  Quick lookup from column name to column index

• _rframeData :: !(Vector (Vector v))

  Vector of rows. Each element should be the length of number of columns.

Instances

Functor (RFrame k)

Methods

fmap :: (a -> b) -> RFrame k a -> RFrame k b

(<$) :: a -> RFrame k b -> RFrame k a

(Eq v, Eq k) => Eq (RFrame k v)

Methods

(==) :: RFrame k v -> RFrame k v -> Bool

(/=) :: RFrame k v -> RFrame k v -> Bool

(Show v, Show k) => Show (RFrame k v)

Methods

showsPrec :: Int -> RFrame k v -> ShowS

show :: RFrame k v -> String

showList :: [RFrame k v] -> ShowS

data RFrameUpdate k v

A simpler RFrame for updates

Constructors

RFrameUpdate

Fields

• _rframeUpdateKeys :: !(Vector k)

  Ordered vector of column names

• _rframeUpdateData :: !(Vector (Vector v))

  Vector of rows.

Instances

Functor (RFrameUpdate k)

Methods

fmap :: (a -> b) -> RFrameUpdate k a -> RFrameUpdate k b

(<$) :: a -> RFrameUpdate k b -> RFrameUpdate k a

(Eq v, Eq k) => Eq (RFrameUpdate k v)

Methods

(==) :: RFrameUpdate k v -> RFrameUpdate k v -> Bool

(/=) :: RFrameUpdate k v -> RFrameUpdate k v -> Bool

(Show v, Show k) => Show (RFrameUpdate k v)

Methods

showsPrec :: Int -> RFrameUpdate k v -> ShowS

show :: RFrameUpdate k v -> String

showList :: [RFrameUpdate k v] -> ShowS

type RFrameMap k v a = Vector k -> HashMap k Int -> Int -> Vector v -> a

Alias for a function to be applied to each row

type RFrameFilter k v = RFrameMap k v Bool

Alias for a row filter

empty :: RFrame k v

An empty frame with no rows or columns

fromUpdate :: (Data k, MonadThrow m) => RFrameUpdate k v -> m (RFrame k v)

Build an RFrame from an RFrameUpdate. Throws on duplicate keys.

toUpdate :: Data k => RFrame k v -> RFrameUpdate k v

Build an RFrameUpdate from an RFrame

numCols :: RFrame k v -> Int

Number of columns in an RFrame

numRows :: RFrame k v -> Int

Number of rows in an RFrame

col :: (Data k, MonadThrow m) => k -> RFrame k v -> m (Vector v)

Project to the given column

decode :: (Data k, MonadThrow m) => Decoder m k v a -> RFrame k v -> m (Vector (m a))

Decode by row. Each element of the returned vector may fail on decoding error so flatten manually or use flatDecode.

flatDecode :: (Data k, MonadThrow m) => Decoder m k v a -> RFrame k v -> m (Vector a)

An auto-flattened version of decode.

filter :: Data k => RFrameFilter k v -> RFrame k v -> RFrame k v

Filter an RFrame by row

update :: (Data k, MonadThrow m) => RFrameUpdate k v -> RFrame k v -> m (RFrame k v)

Update row-wise, adding or replacing values per-column. Retains the existing column order, appending new columns. Throws on row length mismatch or duplicate columns in the update.

splitCols :: Data k => (k -> Bool) -> RFrame k v -> (RFrame k v, RFrame k v)

Split columns in an RFrame by a predicate.

dropCols :: Data k => (k -> Bool) -> RFrame k v -> RFrame k v

Drop columns in an RFrame by a predicate.

keepCols :: Data k => (k -> Bool) -> RFrame k v -> RFrame k v

Keep columns in an RFrame by a predicate.

appendRows :: (Data k, MonadThrow m) => RFrame k v -> RFrame k v -> m (RFrame k v)

Appends rows to an RFrame, retaining column order of the first. Throws on column mismatch.

extendCols :: (Data k, MonadThrow m) => RFrame k v -> RFrame k v -> m (RFrame k v)

Appends columns to an RFrame, retaining column order of the first.

takeRows :: Int -> RFrame k v -> RFrame k v

Takes first n rows of an RFrame.