View Probabilistic periodic frequent itemsets with the Visual Pattern Viewer (SPMF documentation)

Probabilistic periodic frequent itemsets are a type of patterns that can be produced by different algorithms offered in SPMF.

This page explains how to visualize the probabilistic periodic frequent itemsets found by an algorithm using the Visual Pattern Viewer.

How to run this example?

If you want to run this example using the graphical user interface of SPMF, follow these steps.

1) First, select an probabilistic periodic frequent itemset mining algorithm offered in SPMF. Several algorithms are offered and are described in the documentation of SPMF.

2) Then, in the user interface of SPMF, after selecting an algorithm and setting its input file path, output file path, and parameters, click on "Run algorithm" to run the algorithm.

3) After the algorithm terminates, click on the button "View output with :", and select "Visualize_probabilistic_periodic_frequent_itemsets" from the menu to visualize the discovered patterns using the visual pattern viewer.

visualize association rules selection

 

visualize rules viewer

The Visual Pattern Viewer interface is quite intuitive. It displays each pattern with its value for each evaluation measure using a colored bar.

The Visual Pattern Viewer offers several features such as:

Other ways of running the Visual Pattern Viewer

It is also possible to run the Visual Pattern Viewer as an algorithm from the GUI of SPMF..

In this case, in the user interface of SPMF, select "Visualize_probabilistic_periodic_frequent_itemsets" as algorithm. Then, select a file containing probabilistic periodic frequent itemsets as input file. Then, click "run algorithm".

This will display the patterns from the file using the Visual Pattern Viewer.

Besides, it is also possible to call the Visual Pattern Viewer from the command line interface of SPMF. To open a file called patternsUncertainProbabPatterns.txt, this syntax can be used:

java -jar spmf.jar run Visualize_probabilistic_periodic_frequent_itemsets patternsUncertainProbabPatterns.txt in a folder containing spmf.jar and the input file.

What is the input file format?

The algorithm takes as input a file containing probabilistic periodic frequent itemsets .

The file format is defined as follows. It is a text file. The two first lines are metadata indicating the type of patterns and the software that has generated the patterns. Then the following line is the list of patterns, where each line represents a probabilistic periodic frequent pattern. On each line, the items of the pattern are listed in ascending order, each followed by a single space. Then, the keyword "#SUP:" appears and is followed by the expected support of the pattern, then the keyword "#MAXPER:" appears and is followed by the periodicity of the pattern, and finally the keyword "#PROBPER:" appears and is followed by the probability of periodicity of the pattern. Real values are written with at most 12 significant digits. For example, we show below the output file for this example.

@FILETYPE="Probabilistic periodic frequent itemsets"
@SOURCE="SPMF SOFTWARE https://philippe-fournier-viger.com/spmf/"
1 #SUP: 4.2 #MAXPER: 3 #PROBPER: 1
1 3 #SUP: 3.6 #MAXPER: 3 #PROBPER: 0.7168
2 #SUP: 4.5 #MAXPER: 3 #PROBPER: 0.81
3 #SUP: 7.6 #MAXPER: 2 #PROBPER: 0.9904128

For example, the second line indicates that the itemset {1, 3} has an expected support of 3.6, a periodicity of 3 and a probability of periodicity of 0.7168. The following lines follow the same format. Note that the order of the lines may differ from the one shown above.