# Spatial High Utility itemSet Mining (SHUIM) aims to discover all itemSets in a spatioTemporal database
# that satisfy the user-specified minimum utility and maximum distance constraints
#
# **Importing this algorithm into a python program**
# --------------------------------------------------------
#
# from PAMI.highUtilitySpatialPattern.basic import SHUIM as alg
#
# obj=alg.SHUIM("input.txt","Neighbours.txt",35)
#
# obj.mine()
#
# frequentPatterns = obj.getPatterns()
#
# print("Total number of Spatial high utility Patterns:", len(frequentPatterns))
#
# obj.save("output")
#
# memUSS = obj.getMemoryUSS()
#
# print("Total Memory in USS:", memUSS)
#
# memRSS = obj.getMemoryRSS()
#
# print("Total Memory in RSS", memRSS)
#
# run = obj.getRuntime()
#
# print("Total ExecutionTime in seconds:", run)
#
__copyright__ = """
Copyright (C) 2021 Rage Uday Kiran
This program is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.
This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.
You should have received a copy of the GNU General Public License
along with this program. If not, see <https://www.gnu.org/licenses/>.
Copyright (C) 2021 Rage Uday Kiran
"""
from PAMI.highUtilitySpatialPattern.basic import abstract as _ab
from typing import List, Dict, Tuple, Set, Union, Any, Generator, Optional, TypeVar
from functools import cmp_to_key as _cmpToKey
import pandas as pd
from deprecated import deprecated
class _Transaction:
"""
A class to store Transaction of a database
:Attributes:
items: list
A list of items in transaction
utilities: list
A list of utilities of items in transaction
transactionUtility: int
represent total sum of all utilities in the database
pmus: list
represent the pmu (probable maximum utility) of each element in the transaction
prefixUtility:
prefix Utility values of item
offset:
an offset pointer, used by projected transactions
:Methods:
projectedTransaction(offsetE):
A method to create new Transaction from existing till offsetE
getItems():
return items in transaction
getUtilities():
return utilities in transaction
getPmus():
return pmus in transaction
getLastPosition():
return last position in a transaction
removeUnpromisingItems():
A method to remove items with low Utility than minUtil
insertionSort():
A method to sort all items in the transaction
"""
offset = 0
prefixUtility = 0
Self = TypeVar("Self", bound="_Transaction")
def __init__(self, items: List[int], utilities: List[int], transactionUtility: int, pmus: Optional[List[int]]=None) -> None:
self.items = items
self.utilities = utilities
self.transactionUtility = transactionUtility
if pmus is not None:
self.pmus = pmus
def projectTransaction(self, offsetE: int) -> Self:
"""
A method to create new Transaction from existing till offsetE
:param offsetE: an offset over the original transaction for projecting the transaction
:type offsetE: int
"""
new_transaction = _Transaction(self.items, self.utilities, self.transactionUtility)
utilityE = self.utilities[offsetE]
new_transaction.prefixUtility = self.prefixUtility + utilityE
new_transaction.transactionUtility = self.transactionUtility - utilityE
for i in range(self.offset, offsetE):
new_transaction.transactionUtility -= self.utilities[i]
new_transaction.offset = offsetE + 1
return new_transaction
def getItems(self) -> List[int]:
"""
A method to return items in transaction
"""
return self.items
def getPmus(self) -> List[int]:
"""
A method to return pmus in transaction
:return: pmus in transaction
:rtype: list
"""
return self.pmus
def getUtilities(self) -> List[int]:
"""
A method to return utilities in transaction
:return: utilities in transaction
:rtype: list
"""
return self.utilities
# get the last position in this transaction
def getLastPosition(self) -> int:
"""
A method to return last position in a transaction
:return: last position in a transaction
:rtype: int
"""
return len(self.items) - 1
def removeUnpromisingItems(self, oldNamesToNewNames: Dict[int, int]) -> None:
"""
A method to remove items with low Utility than minUtil
:param oldNamesToNewNames: A map represent old names to new names
:type oldNamesToNewNames: map
:return: None
"""
tempItems = []
tempUtilities = []
for idx, item in enumerate(self.items):
if item in oldNamesToNewNames:
tempItems.append(oldNamesToNewNames[item])
tempUtilities.append(self.utilities[idx])
else:
self.transactionUtility -= self.utilities[idx]
self.items = tempItems
self.utilities = tempUtilities
self.insertionSort()
def insertionSort(self) -> None:
"""
A method to sort items in order
:return: None
"""
for i in range(1, len(self.items)):
key = self.items[i]
utilityJ = self.utilities[i]
j = i - 1
while j >= 0 and key < self.items[j]:
self.items[j + 1] = self.items[j]
self.utilities[j + 1] = self.utilities[j]
j -= 1
self.items[j + 1] = key
self.utilities[j + 1] = utilityJ
class _Dataset:
"""
A class represent the list of transactions in this dataset
:Attributes:
transactions :
the list of transactions in this dataset
maxItem:
the largest item name
:methods:
createTransaction(line):
Create a transaction object from a line from the input file
getMaxItem():
return Maximum Item
getTransactions():
return transactions in database
"""
transactions = []
maxItem = 0
def __init__(self, datasetpath: str, sep: str) -> None:
self.strToInt = {}
self.intToStr = {}
self.cnt = 1
self.sep = sep
self.transactions = []
with open(datasetpath, 'r') as f:
lines = f.readlines()
for line in lines:
self.transactions.append(self.createTransaction(line))
f.close()
def createTransaction(self, line: str) -> _Transaction:
"""
A method to create Transaction from dataset given
:param line: represent a single line of database
:type line: string
:return : Transaction.
:rtype: Transaction
"""
trans_list = line.strip().split(':')
transactionUtility = int(trans_list[1])
itemsString = trans_list[0].strip().split(self.sep)
utilityString = trans_list[2].strip().split(self.sep)
pmuString = trans_list[3].strip().split(self.sep)
items = []
utilities = []
pmus = []
for idx, item in enumerate(itemsString):
if self.strToInt.get(item) is None:
self.strToInt[item] = self.cnt
self.intToStr[self.cnt] = item
self.cnt += 1
item_int = self.strToInt.get(item)
if item_int > self.maxItem:
self.maxItem = item_int
items.append(item_int)
utilities.append(int(utilityString[idx]))
pmus.append(int(pmuString[idx]))
return _Transaction(items, utilities, transactionUtility, pmus)
def getMaxItem(self) -> int:
"""
A method to return name of the largest item
:return: the largest item in the list
:rtype: int
"""
return self.maxItem
def getTransactions(self) -> List[_Transaction]:
"""
A method to return transactions from database
:return: the list of transactions stored in the database
:rtype: list
"""
return self.transactions
[docs]
class SHUIM(_ab._utilityPatterns):
"""
:Description:
Spatial High Utility itemSet Mining (SHUIM) aims to discover all itemSets in a spatioTemporal database
that satisfy the user-specified minimum utility and maximum distance constraints
:Reference:
Rage, Uday & Veena, Pamalla & Penugonda, Ravikumar & Raj, Bathala & Dao, Minh & Zettsu, Koji & Bommisetti, Sai.
(2023). HDSHUI-miner: a novel algorithm for discovering spatial high-utility itemsets in high-dimensional
spatiotemporal databases. Applied Intelligence. 53. 1-26. 10.1007/s10489-022-04436-w.
:param iFile: str :
Name of the Input file to mine complete set of High Utility Spatial patterns
:param oFile: str :
Name of the output file to store complete set of High Utility Spatial patterns
:param minSup: int or float or str :
The user can specify minSup either in count or proportion of database size. If the program detects the data type of minSup is integer, then it treats minSup is expressed in count. Otherwise, it will be treated as float.
:param maxPer: float :
The user can specify maxPer in count or proportion of database size. If the program detects the data type of maxPer is integer, then it treats maxPer is expressed in count.
:param minUtil: int :
Minimum utility threshold given by User
:param maxMemory: int :
Maximum memory used by this program for running
:param candidateCount: int :
Number of candidates to consider when calculating a high utility spatial pattern
:param nFile: str :
Name of the input file to mine complete set of High Utility Spatial patterns
:param sep: str :
This variable is used to distinguish items from one another in a transaction. The default seperator is tab space. However, the users can override their default separator.
:Attributes:
iFile : file
Name of the input file to mine complete set of frequent patterns
nFile : file
Name of the Neighbours file that contain neighbours of items
oFile : file
Name of the output file to store complete set of frequent patterns
memoryRSS : float
To store the total amount of RSS memory consumed by the program
startTime:float
To record the start time of the mining process
endTime:float
To record the completion time of the mining process
minUtil : int
The user given minUtil
highUtilityItemSets: map
set of high utility itemSets
candidateCount: int
Number of candidates
utilityBinArrayLU: list
A map to hold the pmu values of the items in database
utilityBinArraySU: list
A map to hold the subtree utility values of the items is database
oldNamesToNewNames: list
A map to hold the subtree utility values of the items is database
newNamesToOldNames: list
A map to store the old name corresponding to new name
Neighbours : map
A dictionary to store the neighbours of a item
maxMemory:Maximum memory used by this program for running
patternCount: int
Number of SHUI's
itemsToKeep: list
keep only the promising items ie items having twu >= minUtil
itemsToExplore: list
keep items that subtreeUtility grater than minUtil
:Methods:
mine()
Mining process will start from here
getPatterns()
Complete set of patterns will be retrieved with this function
save(oFile)
Complete set of frequent patterns will be loaded in to a output file
getPatternsAsDataFrame()
Complete set of frequent patterns will be loaded in to a dataframe
getMemoryUSS()
Total amount of USS memory consumed by the mining process will be retrieved from this function
getMemoryRSS()
Total amount of RSS memory consumed by the mining process will be retrieved from this function
getRuntime()
Total amount of runtime taken by the mining process will be retrieved from this function
calculateNeighbourIntersection(self, prefixLength)
A method to return common Neighbours of items
backtrackingEFIM(transactionsOfP, itemsToKeep, itemsToExplore, prefixLength)
A method to mine the SHUIs Recursively
useUtilityBinArraysToCalculateUpperBounds(transactionsPe, j, itemsToKeep, neighbourhoodList)
A method to calculate the sub-tree utility and local utility of all items that can extend itemSet P and e
output(tempPosition, utility)
A method ave a high-utility itemSet to file or memory depending on what the user chose
_isEqual(transaction1, transaction2)
A method to Check if two transaction are identical
intersection(lst1, lst2)
A method that return the intersection of 2 list
useUtilityBinArrayToCalculateSubtreeUtilityFirstTime(dataset)
Scan the initial database to calculate the subtree utility of each items using a utility-bin array
sortDatabase(self, transactions)
A Method to sort transaction in the order of PMU
sort_transaction(self, trans1, trans2)
A Method to sort transaction in the order of PMU
useUtilityBinArrayToCalculateLocalUtilityFirstTime(self, dataset)
A method to scan the database using utility bin array to calculate the pmus
**Executing the code on terminal:**
---------------------------------------
.. code-block:: console
Format:
(.venv) $ python3 SHUIM.py <inputFile> <outputFile> <Neighbours> <minUtil> <sep>
Example Usage:
(.venv) $ python3 SHUIM.py sampleTDB.txt output.txt sampleN.txt 35
.. note:: minSup will be considered in percentage of database transactions
**Sample run of importing the code:**
--------------------------------------
.. code-block:: python
from PAMI.highUtilitySpatialPattern.basic import SHUIM as alg
obj=alg.SHUIM("input.txt","Neighbours.txt",35)
obj.mine()
frequentPatterns = obj.getPatterns()
print("Total number of Spatial high utility Patterns:", len(frequentPatterns))
obj.save("output")
memUSS = obj.getMemoryUSS()
print("Total Memory in USS:", memUSS)
memRSS = obj.getMemoryRSS()
print("Total Memory in RSS", memRSS)
run = obj.getRuntime()
print("Total ExecutionTime in seconds:", run)
**Credits:**
--------------
The complete program was written by Pradeep Pallikila under the supervision of Professor Rage Uday Kiran.
"""
_highUtilityItemSets = []
_candidateCount = 0
_utilityBinArrayLU = {}
_utilityBinArraySU = {}
_oldNamesToNewNames = {}
_newNamesToOldNames = {}
_strToInt = {}
_intToStr = {}
_Neighbours = {}
_temp = [0] * 5000
_maxMemory = 0
_startTime = float()
_endTime = float()
_minSup = str()
_maxPer = float()
_finalPatterns = {}
_iFile = " "
_oFile = " "
_nFile = " "
_sep = "\t"
_minUtil = 0
_memoryUSS = float()
_memoryRSS = float()
#_dataset = None
#_patternCount = None
def __init__(self, iFile: str, nFile: str, minUtil: int, sep: str="\t") -> None:
super().__init__(iFile, nFile, minUtil, sep)
[docs]
@deprecated("It is recommended to use 'mine()' instead of 'mine()' for mining process. Starting from January 2025, 'mine()' will be completely terminated.")
def startMine(self) -> None:
"""
main program to start the operation
"""
self.mine()
[docs]
def mine(self) -> None:
"""
main program to start the operation
"""
self._startTime = _ab._time.time()
self._patternCount = 0
self._finalPatterns = {}
self._dataset = _Dataset(self._iFile, self._sep)
with open(self._nFile, 'r') as o:
lines = o.readlines()
for line in lines:
line = line.split("\n")[0]
line_split = line.split(self._sep)
line_split = [i.strip() for i in line_split]
item = self._dataset.strToInt.get(line_split[0])
lst = []
for i in range(1, len(line_split)):
lst.append(self._dataset.strToInt.get(line_split[i]))
self._Neighbours[item] = lst
o.close()
#print(len(self._Neighbours))
InitialMemory = _ab._psutil.virtual_memory()[3]
self._useUtilityBinArrayToCalculateLocalUtilityFirstTime(self._dataset)
itemsToKeep = []
for key in self._utilityBinArrayLU.keys():
if self._utilityBinArrayLU[key] >= self._minUtil:
itemsToKeep.append(key)
itemsToKeep = sorted(itemsToKeep, key=lambda x: self._utilityBinArrayLU[x])
currentName = 1
for idx, item in enumerate(itemsToKeep):
self._oldNamesToNewNames[item] = currentName
self._newNamesToOldNames[currentName] = item
itemsToKeep[idx] = currentName
currentName += 1
for transaction in self._dataset.getTransactions():
transaction.removeUnpromisingItems(self._oldNamesToNewNames)
self._sortDatabase(self._dataset.getTransactions())
emptyTransactionCount = 0
for transaction in self._dataset.getTransactions():
if len(transaction.getItems()) == 0:
emptyTransactionCount += 1
self._dataset.transactions = self._dataset.transactions[emptyTransactionCount:]
self._useUtilityBinArrayToCalculateSubtreeUtilityFirstTime(self._dataset)
itemsToExplore = []
for item in itemsToKeep:
if self._utilityBinArraySU[item] >= self._minUtil:
itemsToExplore.append(item)
commonitems = []
for i in range(self._dataset.maxItem):
commonitems.append(i)
self._backtrackingEFIM(self._dataset.getTransactions(), itemsToKeep, itemsToExplore, 0)
finalMemory = _ab._psutil.virtual_memory()[3]
memory = (finalMemory - InitialMemory) / 10000
if memory > self._maxMemory:
self._maxMemory = memory
self._endTime = _ab._time.time()
process = _ab._psutil.Process(_ab._os.getpid())
self._memoryUSS = float()
self._memoryRSS = float()
self._memoryUSS = process.memory_full_info().uss
self._memoryRSS = process.memory_info().rss
def _backtrackingEFIM(self, transactionsOfP: List[_Transaction], itemsToKeep: List[int], itemsToExplore: List[int], prefixLength: int) -> None:
"""
A method to mine the SHUIs Recursively
:param transactionsOfP: the list of transactions containing the current prefix P
:type transactionsOfP: list
:param itemsToKeep: the list of secondary items in the p-projected database
:type itemsToKeep: list
:param itemsToExplore: the list of primary items in the p-projected database
:type itemsToExplore: list
:param prefixLength: current prefixLength
:type prefixLength: int
:return: None
"""
self._candidateCount += len(itemsToExplore)
for idx, e in enumerate(itemsToExplore):
initialMemory = _ab._psutil.virtual_memory()[3]
transactionsPe = []
utilityPe = 0
previousTransaction = transactionsOfP[0]
consecutiveMergeCount = 0
for transaction in transactionsOfP:
items = transaction.getItems()
if e in items:
positionE = items.index(e)
if transaction.getLastPosition() == positionE:
utilityPe += transaction.getUtilities()[positionE] + transaction.prefixUtility
else:
projectedTransaction = transaction.projectTransaction(positionE)
utilityPe += projectedTransaction.prefixUtility
if previousTransaction == transactionsOfP[0]:
previousTransaction = projectedTransaction
elif self._isEqual(projectedTransaction, previousTransaction):
if consecutiveMergeCount == 0:
items = previousTransaction.items[previousTransaction.offset:]
utilities = previousTransaction.utilities[previousTransaction.offset:]
itemsCount = len(items)
positionPrevious = 0
positionProjection = projectedTransaction.offset
while positionPrevious < itemsCount:
utilities[positionPrevious] += projectedTransaction.utilities[positionProjection]
positionPrevious += 1
positionProjection += 1
previousTransaction.prefixUtility += projectedTransaction.prefixUtility
sumUtilities = previousTransaction.prefixUtility
previousTransaction = _Transaction(items, utilities, previousTransaction.transactionUtility + projectedTransaction.transactionUtility)
previousTransaction.prefixUtility = sumUtilities
else:
positionPrevious = 0
positionProjected = projectedTransaction.offset
itemsCount = len(previousTransaction.items)
while positionPrevious < itemsCount:
previousTransaction.utilities[positionPrevious] += projectedTransaction.utilities[
positionProjected]
positionPrevious += 1
positionProjected += 1
previousTransaction.transactionUtility += projectedTransaction.transactionUtility
previousTransaction.prefixUtility += projectedTransaction.prefixUtility
consecutiveMergeCount += 1
else:
transactionsPe.append(previousTransaction)
previousTransaction = projectedTransaction
consecutiveMergeCount = 0
transaction.offset = positionE
if previousTransaction != transactionsOfP[0]:
transactionsPe.append(previousTransaction)
self._temp[prefixLength] = self._newNamesToOldNames[e]
if utilityPe >= self._minUtil:
self._output(prefixLength, utilityPe)
neighbourhoodList = self._calculateNeighbourIntersection(prefixLength)
self._useUtilityBinArraysToCalculateUpperBounds(transactionsPe, idx, itemsToKeep, neighbourhoodList)
newItemsToKeep = []
newItemsToExplore = []
for l in range(idx + 1, len(itemsToKeep)):
itemK = itemsToKeep[l]
if self._utilityBinArraySU[itemK] >= self._minUtil:
if itemK in neighbourhoodList:
newItemsToExplore.append(itemK)
newItemsToKeep.append(itemK)
elif self._utilityBinArrayLU[itemK] >= self._minUtil:
if itemK in neighbourhoodList:
newItemsToKeep.append(itemK)
self._backtrackingEFIM(transactionsPe, newItemsToKeep, newItemsToExplore, prefixLength + 1)
finalMemory = _ab._psutil.virtual_memory()[3]
memory = (finalMemory - initialMemory) / 10000
if self._maxMemory < memory:
self._maxMemory = memory
def _useUtilityBinArraysToCalculateUpperBounds(self, transactionsPe: List[_Transaction], j: int, itemsToKeep: List[int], neighbourhoodList: List[int]) -> None:
"""
A method to calculate the subtree utility and local utility of all items that can extend itemSet P U {e}
:param transactionsPe: transactions the projected database for P U {e}
:type transactionsPe: list
:param j:the position of j in the list of promising items
:type j:int
:param itemsToKeep :the list of promising items
:type itemsToKeep: list
:return: None
"""
for i in range(j + 1, len(itemsToKeep)):
item = itemsToKeepi
self._utilityBinArrayLU[item] = 0
self._utilityBinArraySU[item] = 0
for transaction in transactionsPe:
length = len(transaction.getItems())
i = length - 1
while i >= transaction.offset:
item = transaction.getItems()[i]
if item in itemsToKeep:
remainingUtility = 0
if self._newNamesToOldNames[item] in self._Neighbours:
item_neighbours = self._Neighbours[self._newNamesToOldNames[item]]
for k in range(i, length):
transaction_item = transaction.getItems()[k]
if self._newNamesToOldNames[transaction_item] in item_neighbours and transaction_item in neighbourhoodList:
remainingUtility += transaction.getUtilities()[k]
remainingUtility += transaction.getUtilities()[i]
self._utilityBinArraySU[item] += remainingUtility + transaction.prefixUtility
self._utilityBinArrayLU[item] += transaction.transactionUtility + transaction.prefixUtility
i -= 1
def _calculateNeighbourIntersection(self, prefixLength: int) -> List[int]:
"""
A method to find common Neighbours
:param prefixLength: the prefix itemSet
:type prefixLength:int
:return: the common neighbours
:rtype: list
"""
intersectionList = self._Neighbours.get(self._temp[0])
for i in range(1, prefixLength + 1):
intersectionList = self._intersection(self._Neighbours[self._temp[i]], intersectionList)
finalIntersectionList = []
if intersectionList is None:
return finalIntersectionList
for item in intersectionList:
if item in self._oldNamesToNewNames:
finalIntersectionList.append(self._oldNamesToNewNames[item])
return finalIntersectionList
def _output(self, tempPosition: int, utility: int) -> None:
"""
A method save all high-utility itemSet to file or memory depending on what the user chose
:param tempPosition: position of last item
:type tempPosition : int
:param utility: total utility of itemSet
:type utility: int
:return: None
"""
self._patternCount += 1
s1 = str()
for i in range(0, tempPosition + 1):
s1 += self._dataset.intToStr.get((self._temp[i]))
if i != tempPosition:
s1 += "\t"
self._finalPatterns[s1] = str(utility)
def _isEqual(self, transaction1: _Transaction, transaction2: _Transaction) -> bool:
"""
A method to Check if two transaction are identical
:param transaction1: the first transaction.
:type transaction1: Transaction
:param transaction2: the second transaction.
:type transaction2: Transaction
:return : whether both are identical or not
:rtype: bool
"""
length1 = len(transaction1.items) - transaction1.offset
length2 = len(transaction2.items) - transaction2.offset
if length1 != length2:
return False
position1 = transaction1.offset
position2 = transaction2.offset
while position1 < len(transaction1.items):
if transaction1.items[position1] != transaction2.items[position2]:
return False
position1 += 1
position2 += 1
return True
def _intersection(self, lst1: List[int], lst2: List[int]) -> List[int]:
"""
A method that return the intersection of 2 list
:param lst1: items neighbour to item1
:type lst1: list
:param lst2: items neighbour to item2
:type lst2: list
:return :intersection of two lists
:rtype : list
"""
temp = set(lst2)
lst3 = [value for value in lst1 if value in temp]
return lst3
def _useUtilityBinArrayToCalculateSubtreeUtilityFirstTime(self, dataset: _Dataset) -> None:
"""
Scan the initial database to calculate the subtree utility of each item using a utility-bin array
:param dataset: the transaction database
:type dataset: Dataset
:return: None
"""
for transaction in dataset.getTransactions():
items = transaction.getItems()
utilities = transaction.getUtilities()
for idx, item in enumerate(items):
if item not in self._utilityBinArraySU:
self._utilityBinArraySU[item] = 0
if self._newNamesToOldNames[item] not in self._Neighbours:
self._utilityBinArraySU[item] += utilities[idx]
continue
i = idx + 1
sumSu = utilities[idx]
while i < len(items):
if self._newNamesToOldNames[items[i]] in self._Neighbours[self._newNamesToOldNames[item]]:
sumSu += utilities[i]
i += 1
self._utilityBinArraySU[item] += sumSu
def _sortDatabase(self, transactions: List[_Transaction]) -> None:
"""
A Method to sort transaction in the order of PMU
:param transactions: transaction of items
:type transactions: Transaction
:return: sorted transaction.
:rtype: Transaction
"""
cmp_items = _cmpToKey(self._sortTransaction)
transactions.sort(key=cmp_items)
def _sortTransaction(self, trans1: _Transaction, trans2: _Transaction) -> int:
"""
A Method to sort transaction in the order of PMU
:param trans1: the first transaction.
:type trans1: Transaction
:param trans2:the second transaction.
:type trans2: Transaction
:return: sorted transaction.
:rtype: int
"""
trans1_items = trans1.getItems()
trans2_items = trans2.getItems()
pos1 = len(trans1_items) - 1
pos2 = len(trans2_items) - 1
if len(trans1_items) < len(trans2_items):
while pos1 >= 0:
sub = trans2_items[pos2] - trans1_items[pos1]
if sub != 0:
return sub
pos1 -= 1
pos2 -= 1
return -1
elif len(trans1_items) > len(trans2_items):
while pos2 >= 0:
sub = trans2_items[pos2] - trans1_items[pos1]
if sub != 0:
return sub
pos1 -= 1
pos2 -= 1
return 1
else:
while pos2 >= 0:
sub = trans2_items[pos2] - trans1_items[pos1]
if sub != 0:
return sub
pos1 -= 1
pos2 -= 1
return 0
def _useUtilityBinArrayToCalculateLocalUtilityFirstTime(self, dataset: _Dataset) -> None:
"""
A method to scan the database using utility bin array to calculate the pmus
:param dataset: the transaction database.
:type dataset: database
:return: None
"""
for transaction in dataset.getTransactions():
for idx, item in enumerate(transaction.getItems()):
if item in self._utilityBinArrayLU:
self._utilityBinArrayLU[item] += transaction.getPmus()[idx]
else:
self._utilityBinArrayLU[item] = transaction.getPmus()[idx]
[docs]
def getPatternsAsDataFrame(self) -> pd.DataFrame:
"""
Storing final patterns in a dataframe
:return: returning patterns in a dataframe
:rtype: pd.DataFrame
"""
dataFrame = {}
data = []
for a, b in self._finalPatterns.items():
data.append([a.replace('\t', ' '), b])
dataFrame = _ab._pd.DataFrame(data, columns=['Patterns', 'Utility'])
return dataFrame
[docs]
def getPatterns(self) -> Dict[str, str]:
"""
Function to send the set of patterns after completion of the mining process
:return: returning patterns
:rtype: dict
"""
return self._finalPatterns
[docs]
def save(self, outFile: str) -> None:
"""
Complete set of patterns will be loaded in to an output file
:param outFile: name of the output file
:type outFile: csv file
:return: None
"""
self._oFile = outFile
writer = open(self._oFile, 'w+')
for x, y in self._finalPatterns.items():
patternsAndSupport = x.strip() + ":" + str(y)
writer.write("%s \n" % patternsAndSupport)
[docs]
def getMemoryUSS(self) -> float:
"""
Total amount of USS memory consumed by the mining process will be retrieved from this function
:return: returning USS memory consumed by the mining process
:rtype: float
"""
return self._memoryUSS
[docs]
def getRuntime(self) -> float:
"""
Calculating the total amount of runtime taken by the mining process
:return: returning total amount of runtime taken by the mining process
:rtype: float
"""
return self._endTime-self._startTime
[docs]
def printResults(self) -> None:
"""
This function is used to print the results
"""
print("Total number of Spatial High Utility Patterns:", len(self.getPatterns()))
print("Total Memory in USS:", self.getMemoryUSS())
print("Total Memory in RSS", self.getMemoryRSS())
print("Total ExecutionTime in seconds:", self.getRuntime())
if __name__ == '__main__':
_ap = str()
if len(_ab._sys.argv) == 5 or len(_ab._sys.argv) == 6:
if len(_ab._sys.argv) == 6:
_ap = SHUIM(_ab._sys.argv[1], _ab._sys.argv[3], int(_ab._sys.argv[4]), _ab._sys.argv[5])
if len(_ab._sys.argv) == 5:
_ap = SHUIM(_ab._sys.argv[1], _ab._sys.argv[3], int(_ab._sys.argv[4]))
_ap.mine()
_ap.mine()
print("Total number of Spatial High Utility Patterns:", len(_ap.getPatterns()))
_ap.save(_ab._sys.argv[2])
print("Total Memory in USS:", _ap.getMemoryUSS())
print("Total Memory in RSS", _ap.getMemoryRSS())
print("Total ExecutionTime in seconds:", _ap.getRuntime())
else:
for i in [100000, 500000]:
_ap = SHUIM('/Users/Likhitha/Downloads/mushroom_main_2000.txt', '/Users/Likhitha/Downloads/mushroom_neighbors_2000.txt', i, ' ')
_ap.mine()
_ap.mine()
print("Total number of Spatial High Utility Patterns:", len(_ap.getPatterns()))
#_ap.save(_ab._sys.argv[2])
print("Total Memory in USS:", _ap.getMemoryUSS())
print("Total Memory in RSS", _ap.getMemoryRSS())
print("Total ExecutionTime in seconds:", _ap.getRuntime())
print("Error! The number of input parameters do not match the total number of parameters provided")