Skip to content
This repository has been archived by the owner on Dec 30, 2023. It is now read-only.

Latest commit

 

History

History
111 lines (85 loc) · 3.9 KB

README.md

File metadata and controls

111 lines (85 loc) · 3.9 KB
Raw

ExPanDaR: Explore Panel Data Interactively

Project Status: Active – The project has reached a stable, usable state and is being actively developed. Travis-CI Build Status CRAN_Status_Badge CRAN_Download_Badge

Overview

You are visiting the github repository of the ExPanDaR (Explore Panel Data with R) package. ExPanDaR provides the code base for the ExPanD web app. ExPanD is a shiny based app supporting interactive exploratory data analysis.

ExPanD has two purposes:

  • Enable users to assess the robustness of empirical evidence without providing them with access to the underlying data.
  • Provide a toolbox for researchers to explore panel data on the fly, now also allowing them to download R notebook code that reflects their analysis.

While I hope that ExPanD will be particularly helpful in the academic review, publication and replication process I also think that it is convenient for typical exploratory data analysis workflows. In addition, it has already proven to be helpful in the classroom.

This is what ExPanD looks like:

If you are interested to see what ExPanD has to offer without diving into R, click here to explore an instance of ExPanD that hosts World Bank data or click here for a financial accounting and stock returns dataset of U.S. firms.

If you want to analyze your own panel data instead, you can also access a variant of ExPanD app here that allows user-side data uploads. No worries: Your data won’t be stored on the server and will get erased from memory as soon as you close the web connection.

Installation

If you are in for the full treat and want to test ExPanD from within R, run the following in your R session to install the ExPanDaR package from CRAN.

install.packages("ExPanDaR")
library(ExPanDaR)

Or, if you want to install the current development version from Github that includes the new notebook export option:

if (!require("devtools")) {
  install.packages("devtools")
}
devtools::install_github("joachim-gassen/ExPanDaR")
library(ExPanDaR)

Basic Usage

You can either start ExPanD without arguments so that it starts with a file upload dialog…

ExPanD()

…or start with one of the two example datasets that come with the package. Please note: The last parameter (export_nb_option) is currently only supported by the development version of the package available on Github and has to be omitted when you use the CRAN version.

ExPanD(df = worldbank,  
       df_def = worldbank_data_def, 
       var_def = worldbank_var_def,
       df_name = "World Bank Data",
       config_list = ExPanD_config_worldbank,
       export_nb_option = TRUE)

ExPanD(df = russell_3000,  
       df_def = russell_3000_data_def, 
       df_name = "Russell 3000",
       config_list = ExPanD_config_russell_3000,
       export_nb_option = TRUE)

Some additional information on how to use ExPanD can be found in the code file ExPanDaR_examples.R in the root directory.

Further Information

For further information, please refer to the articles and function call references of the package documentation, available here for the CRAN version and here for the current development version.

Enjoy!