-
-
Notifications
You must be signed in to change notification settings - Fork 1
Expand file tree
/
Copy pathREADME.Rmd
More file actions
152 lines (75 loc) · 4.51 KB
/
README.Rmd
File metadata and controls
152 lines (75 loc) · 4.51 KB
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
---
output: github_document
---
<!-- README.md is generated from README.Rmd. Please edit that file -->
```{r, include = FALSE}
knitr::opts_chunk$set(
collapse = TRUE,
comment = "#>",
fig.path = "man/figures/README-",
out.width = "100%"
)
```
# farrell <a><img src='man/figures/hex.png' align="right" height="200" /></a>
<!-- badges: start -->
<!-- [](https://cran.r-project.org/package=farrell) -->
<!-- [](https://cran.r-project.org/package=farrell) -->
<!-- [](https://cran.r-project.org/package=farrell) -->
<!-- [](https://cran.r-project.org/package=farrell) -->
<!-- [](https://cran.r-project.org/package=farrell) -->
[](https://travis-ci.com/feddelegrand7/farrell)
[](https://github.com/feddelegrand7/farrell)
<!-- badges: end -->
The goal of farrell is to provide an interactive interface to Data Envelopment Analysis modeling in R. The farrell package is built upon [Benchmarking](https://CRAN.R-project.org/package=Benchmarking).
## Installation
You can install the development version of `farrell` from Github with:
```{r, eval = FALSE}
# install.packages("remotes")
remotes::install_github("feddelegrand7/farrell")
```
## Example
You can run:
```{r, eval=FALSE}
library(farrell)
farrell()
```
or if you're working on RStudio, just click on __Addins__ then __farrell__.
## Data Loading:
Hit __Browse...__ to upload your data frame in a csv format. All the inputs and outputs must be contained
within the uploaded data frame. Further, the data frame needs to contain an identification column in order
to identify Decision Making Units distinctively. It can be a numeric or a character column.

In the following examples, we use the mtcars data frame which has been exported in a csv format with an additional column: __cars name__.

## Model Tuning

Within the Model Tuning tab, you will select the input and output variables, then you determine your identification column. Then you choose the Returns to Scale assumption between: crs, vrs, irs, drs, add and fdh. After that, you determine the orientation of the model, whether input or output. Finally, hit __Calculate Efficiency__ to get the results.
Let's for example consider __mpg__ and __disp__ as the output variables and __wt__ as input. We choose __cars name__ as the identification column and model an input-oriented model with crs assumption.

## Efficiency Results
The Efficiency Results tab displays the efficiency scores along with the peers for each unit in a descending order. You have the ability to download the result in a csv format. The tab also provides a summary of the distribution of the efficiency scores.

## Lambdas
In the Lambdas tab, you get the contribution of the peers to the inefficient units' score.

## Scale Efficiency
The SE tab provides the Scale Efficiency score of each DMU under consideration.

## Slacks
The Slacks tab displays a data frame containing the sum of the slacks and the slacks for each input/output variables.

## Citation
If you use the farrell package in your publications or teaching activities, please cite it as follows:
Mohamed El Fodil Ihaddaden (2020). farrell: Interactive
Interface to Data Envelopment Analysis Modeling based on the Benchmarking R package. R package version 0.2.0.
https://github.com/feddelegrand7/farrell
A BibTeX entry for LaTeX users is
@Manual{,
title = {farrell: Interactive Interface to Data Envelopment Analysis Modeling based on the Benchmarking R package},
author = {Mohamed El Fodil Ihaddaden},
note = {R package version 0.2.0},
year={2020},
url = {https://github.com/feddelegrand7/farrell},
}
## Code of Conduct
Please note that the farrell project is released with a [Contributor Code of Conduct](https://contributor-covenant.org/version/2/0/CODE_OF_CONDUCT.html). By contributing to this project, you agree to abide by its terms.