NNetEn 1.0.8

Python Package for Neural Network Entropy (NNetEn) calculation

Neural Network Entropy (NNetEn)

Entropy measures are effective features for time series classification problems. Traditional entropy measures, such as Shannon entropy, use probability distribution function. However, for the effective separation of time series, new entropy estimation methods are required to characterize the chaotic dynamic of the system. Our concept of Neural Network Entropy (NNetEn) is based on the classification of special datasets (MNIST-10 and SARS-CoV-2-RBV1) in relation to the entropy of the time series recorded in the reservoir of the LogNNet neural network. NNetEn estimates the chaotic dynamics of time series in an original way. Based on the NNetEn algorithm, we propose two new classification metrics: R2 Efficiency and Pearson Efficiency.

Citing the Work

Link to article

Velichko, A., Belyaev, M., Izotov, Y., Murugappan, M., & Heidari, H. (2023). 
Neural Network Entropy (NNetEn): Entropy-based EEG signal and chaotic time series classification, Python package for NNetEn calculation. 
Algorithms, 16(5), 255. doi:10.3390/a16050255

Installation

Installation is done from pypi using the following command

pip install NNetEn

To update installed package to their latest versions, use the --upgrade option with pip install

pip install --upgrade NNetEn

Usage

Command to create the NNetEn_entropy model

 from NNetEn import NNetEn_entropy

 NNetEn = NNetEn_entropy(database='D1', mu=1)

Arguments:

• database: (default = D1) Select dataset (D1: MNIST, D2 :SARS-CoV-2-RBV1)
• mu: (default = 1) Usage fraction of the selected database (0.01 .. 1).

Output: The LogNNet neural network is operated using normalized training and test sets contained in the NNetEn_entropy class

Command to calculation the NNetEn parameter

NNetEn.calculation(time_series, epoch=20, method=3, metric='Acc', log=False)

Arguments:

• time_series: Input data with a time series in numpy array format.
• epoch: (default = 20) The number of training epochs for the LogNNet neural network, with a number greater than 0.
• method: (default = 3) One of 6 methods for forming a reservoir matrix from the time series M1 ... M6.
• metric: (default = 'Acc') 'Acc' - accuracy metric, 'R2E' - R2 Efficiency metric, 'PE' - Pearson Efficiency metric.
• log: (default = False) Parameter for logging the main data used in the calculation. Recording is done in log.txt file.

Output: Entropy value NNetEn.