SCARF

Simple Combinatorial Association Rule Finder

← Back to SCARF

SCARF is an online tool provided by the PIT Bioinformatics Group for finding (or "mining") combinatorial association rules in data tables.

By using the service you accept our terms of use.

Introduction

Combinatorial association rules are used for discovering relationships between attributes. For instance, if the rows of a data table correspond to transactions, where the items bought are marked with X characters, then association rules can demonstrate which items are frequently bought together.

An example rule could be beer=X & (milk=X or bread=X) ---> banana=X. This rule states that if someone buys beer and either milk or bread, then they will buy banana as well.

There are no "completely false" or "completely true" rules. The strength of a rule can be evaluated through multiple mathematical quantities like universe, support, lift or p-value (see the Glossary).

Using SCARF

First, you will need to upload a data table. The data table must consist of a header and multiple records. Read the description of the accepted table format here. There is an example data table for illustration.

After you have selected the data table, you will have to specify some parameters for rule mining:

PatternA wildcard rule template such as ☐ & (☐ or ☐) ⇒ ☐. The boxes will be filled with elementary equalities (e.g. banana=X).
Max. rule countThe maximum number of rules to output.
Min. universeMinimum universe requirement for a rule (see Glossary).
Min. supportMinimum support requirement for a rule (see Glossary).
Min. confidenceMinimum confidence requirement for a rule (see Glossary).
Min. liftMinimum lift requirement for a rule (see Glossary).
Max. p-valueMaximum p-value requirement for a rule (see Glossary).
ColumnsHere you can specify which columns (i.e. transaction attributes) you want to allow on the LHS/RHS of the rules, respectively. E.g. you can allow 'beer' and 'water' on the left-hand side, and 'apples' and 'oranges' on the right-hand side. In other words, you can use this option to specify which attributes you would like to infer from which attributes.
Name/EmailRule mining is a complex process and usually takes several minutes. Results are not available instantly. Therefore we need your name and e-mail address to send you an e-mail when your results are ready.

The format of the input table

The input table must be a comma- or semicolon-separated CSV file.

  • The separator char is automatically recognized.
  • The character set should be ASCII. Unicode and UTF-8 characters are not recognized.
  • Leading and trailing whitespaces in cells are not considered.

The first row must contain the column names separated by the separator character.
Column names may only contain English letters, numbers, underscores, dots and square brackets. In technical terms, they must match the regular expression ^[a-zA-Z0-9_\.\[\]]+$.

The other rows must contain the data itself.
All attribute values are single characters in SCARF. This means that each cell should be empty or one character long. Cells longer than a character generate a warning, and only the first non-whitespace character of these cells is considered.

Empty cells are used to represent N/A (data not available). Thus you can supply sparse data tables for SCARF if some measurements were not taken for the whole population.

Glossary

ColumnA column of the data table corresponds to an attribute of the entries in the data table. Columns may also be called fields or variables.
A column may have N/A values for some rows, where the corresponding attribute is unknown or missing. This is designated with an empty cell.
ConfidenceThe probability that the RHS is true, supposed that the LHS is true.
In mathematical terms: the conditional probability Pr(LHS and RHS) / Pr(LHS), where the event space consists of the rows of the universe with equal probability assigned.
E-valueBecause SCARF tries out a lot of rule candidates during execution, it is possible that a rule will get a good (i.e. small) p-value by mere chance. Thus the E-value is a more accurate measure of the randomness of a rule. It equals to the p-value, multiplied by the number of all the possible rules examined by SCARF.
The E-value can be viewed as an experiment-wide p-value. The smaller the E-value, the more related the LHS and RHS of a rule.
GoodnessThe goodness of a rule is defined as its lift.
LeverageMeasures the absolute level of dependence between the LHS and the RHS.
In mathematical terms: the difference Pr(LHS and RHS) - Pr(LHS)*Pr(RHS).
LHSLeft-hand side.
LHS supportThe number of data rows in the universe, where the LHS of a rule is true.
LiftMeasures the relative level of dependence between the LHS and the RHS.
In mathematical terms: the ratio Pr(LHS and RHS) / (Pr(LHS)*Pr(RHS)).
N/AData not available. Refers to an unknown (missing) value in the data table.
p-valueThe Chi-Squared test is a well-known method which measures the dependence between the LHS and the RHS. It yields a number between 0 and 1 called the p-value. The smaller the p-value, the more related the LHS and RHS of a rule.
RowA data row is an entry (or record) in the data table. Each row is an assignment of some values to the columns.
RHSRight-hand side.
RHS supportThe number of data rows in the universe, where the RHS of a rule is true.
SupportThe number of data rows in the universe, where both the LHS and RHS are true.
UniverseThe (number of) data rows where all columns occurring in a rule have a non-N/A value.

← Back to SCARF

Terms of use

You can use this service only if you accept the following terms: We do not guarantee anything about this service: We do not state anything about the usability of this service, and we do not state that the results that we may return can be used for any purpose. We cannot guarantee that this service will be available in the future, and we cannot guarantee that your query would generate any output at all.

Privacy: We will not give out your data to anyone, and, regularly, only you can retrieve the results to your query using the unique webpage identifier generated for you. However, we cannot guarantee that others do not intercept the traffic between you and our server. Therefore, do not use our webserver for proprietary data analysis, we cannot guarantee the data integrity and safety for you.

How to cite?

Balazs Szalkai, Vince K. Grolmusz, Vince I. Grolmusz: Identifying Combinatorial Biomarkers by Association Rule Mining in the CAMD Alzheimer's Database, Archives of Gerontology and Geriatrics Vol. 73, pp. 300-307 (2017), https://doi.org/10.1016/j.archger.2017.08.006

Balazs Szalkai, Vince Grolmusz: SCARF: A Biomedical Association Rule Finding Webserver, arXiv preprint arXiv:1709.09850 (2017)