Learn R Programming
EventStudy (version 0.37)

EventStudyAPI: API for https://www.eventstudytools.com

Description

R interface for performing Event Studies on https://www.eventstudytools.com.

For more details see the help vignette: vignette("introduction_eventstudy", package = "EventStudy")

Format

R6Class object

Usage

For usage details see Methods, Arguments, and Examples sections.

Methods

new(apiServerUrl)

This method is used to create an object of this class with apiServerUrl as the url to the EventStudyTools server

authentication(apiKey)

This method is used to authenticate at apiServerUrl. A valid APIkey is required. You can download a free key on our website: https://www.eventstudytools.com

performEventStudy(estParam)

This method starts an Event Study. This method does all the analysis work for you

performDefaultEventStudy()

This method starts a default Event Study. It is a wrapper around performEventStudy

processTask()

This method starts the Event Study calculation on the server (after files are uploaded.

configureTask(input)

This method configures the Event Study. input is an ApplicationInputInterface R6 object, e.g. ARC configuration class

uploadFile(fileKey, fileName)

This method links to the file to upload. fileKey is the key of the file. Valid values are: request_file, firm_data, and market_data. fileName file name to upload.

commitData()

This method commits the data to the server

getTaskStatus()

Check if calculation is finished

getTaskResults(destDir = getwd())

Downloads the result files of the Event Study to destDir (Default: current working directory).

Arguments

eventstudyapi

An EventStudyAPI object

apiServerUrl

URL to the API endpoint

apiKey

Key for authentication

input

An ApplicationInputInterface object.

fileKey

Type of input file: request_file, firm_data, and market_data

fileName

Data filename

destDir

Directory for saving result files

Methods

Method new()

Usage

EventStudyAPI$new(apiServerUrl = NULL)

Method authentication()

Usage

EventStudyAPI$authentication(apiKey = NULL)

Method performEventStudy()

Usage

EventStudyAPI$performEventStudy(
  estParams = NULL,
  dataFiles = c(request_file = "01_RequestFile.csv", firm_data = "02_firmData.csv",
    market_data = "03_MarketData.csv"),
  destDir = "results",
  downloadFiles = T,
  checkFiles = F
)

Method performDefaultEventStudy()

Usage

EventStudyAPI$performDefaultEventStudy(
  estType = "arc",
  dataFiles = c(request_file = "01_RequestFile.csv", firm_data = "02_firmData.csv",
    market_data = "03_MarketData.csv"),
  destDir = "results",
  downloadFiles = T,
  checkFiles = F
)

Method processTask()

Usage

EventStudyAPI$processTask()

Method configureTask()

Usage

EventStudyAPI$configureTask(estParams = NULL)

Method uploadFile()

Usage

EventStudyAPI$uploadFile(fileKey, fileName, partNumber = 0)

Method deleteFileParts()

Usage

EventStudyAPI$deleteFileParts(parts)

Method splitFile()

Usage

EventStudyAPI$splitFile(fileName, maxChunkSize)

Method get_token()

Usage

EventStudyAPI$get_token()

Method commitData()

Usage

EventStudyAPI$commitData()

Method getTaskStatus()

Usage

EventStudyAPI$getTaskStatus(exceptionOnError = FALSE)

Method getTaskResults()

Usage

EventStudyAPI$getTaskResults(downloadFiles = T, destDir = getwd())

Method getApiVersion()

Usage

EventStudyAPI$getApiVersion()

Method clone()

The objects of this class are cloneable with this method.

Usage

EventStudyAPI$clone(deep = FALSE)

Arguments

deep

Whether to make a deep clone.