getenum.single: Get a data.frame of counts from an enumeration

In jayjacobs/verisr: Tools for working with VERIS objects

Description

When exploring VERIS data, you may want to get a simple count of the values within a value or enumeration. Given one or more enumerations, this will return the subsequent underlying logical values in an ordered data frame.

Usage

getenum.single(veris, enum, filter = NULL, add.n = T, add.freq = T)

Arguments

veris	a verisr object
enum	the field to count
filter	limit what records are searched (optional)
add.n	include a total count of variables found (denominator)
add.freq	include a percentage (x/n)

Details

Note there are some special values that can be set as the enumeration, that may not be obvious. : * actor, action, attribute: will all return the next level down. For example, just querying for "action" will return "malware", "hacking", and so on. * action.variety: will return the variety enumerations across all actions (e.g. top N actions) (not in getenumby() yet) * asset.variety: will return the type of assets, "Server", "Network, "User Dev" and so on * victim.industry2: will return a short label of industries based on 2 values of NAICS code. * victim.industry3: will return a short label of industries based on 3 values of NAICS code. * pattern: will return the pattern the incidents are in.

Change in 1.1: the "add.n" and "add.freq" options are now TRUE by default.

Examples

## Not run: 
hacking <- getenum(veris, "action.hacking.variety")
external <- getenum(veris, "actor.external.motive")

## End(Not run)

jayjacobs/verisr documentation built on May 18, 2019, 5:57 p.m.