pyerualjetwork 2.7.8__py3-none-any.whl → 4.1.9__py3-none-any.whl

pyerualjetwork/plan.py

@@ -0,0 +1,664 @@
+# -*- coding: utf-8 -*-
+"""
+
+MAIN MODULE FOR PLAN
+
+PLAN document: https://github.com/HCB06/PyerualJetwork/blob/main/Welcome_to_PLAN/PLAN.pdf
+PYERUALJETWORK document: https://github.com/HCB06/PyerualJetwork/blob/main/Welcome_to_PyerualJetwork/PYERUALJETWORK_USER_MANUEL_AND_LEGAL_INFORMATION(EN).pdf
+
+@author: Hasan Can Beydili
+@YouTube: https://www.youtube.com/@HasanCanBeydili
+@Linkedin: https://www.linkedin.com/in/hasan-can-beydili-77a1b9270/
+@Instagram: https://www.instagram.com/canbeydilj/
+@contact: tchasancan@gmail.com
+"""
+
+import numpy as np
+from colorama import Fore
+import math
+import random
+
+### LIBRARY IMPORTS ###
+from .ui import loading_bars, initialize_loading_bar
+from .data_operations import normalization, decode_one_hot, batcher
+from .loss_functions import binary_crossentropy, categorical_crossentropy
+from .activation_functions import apply_activation, Softmax, all_activations
+from .metrics import metrics
+from .model_operations import get_acc, get_preds, get_preds_softmax
+from .memory_operations import optimize_labels
+from .visualizations import (
+    draw_neural_web,
+    update_neural_web_for_fit,
+    plot_evaluate,
+    update_neuron_history,
+    initialize_visualization_for_fit,
+    update_weight_visualization_for_fit,
+    update_decision_boundary_for_fit,
+    update_validation_history_for_fit,
+    display_visualization_for_fit,
+    display_visualizations_for_learner,
+    update_history_plots_for_learner,
+    initialize_visualization_for_learner,
+    update_neuron_history_for_learner,
+    show
+)
+
+### GLOBAL VARIABLES ###
+bar_format_normal = loading_bars()[0]
+bar_format_learner = loading_bars()[1]
+
+# BUILD -----
+
+def fit(
+    x_train,
+    y_train,
+    val=False,
+    val_count=None,
+    activation_potentiation=['linear'],
+    x_val=None,
+    y_val=None,
+    show_training=None,
+    interval=100,
+    LTD=0,
+    decision_boundary_status=True,
+    train_bar=True,
+    auto_normalization=True,
+    neurons_history=False,
+    dtype=np.float32
+):
+    """
+    Creates a model to fitting data.
+    
+    fit Args:
+
+        x_train (list[num]): List or numarray of input data.
+
+        y_train (list[num]): List or numarray of target labels. (one hot encoded)
+
+        val (None or True): validation in training process ? None or True default: None (optional)
+
+        val_count (None or int): After how many examples learned will an accuracy test be performed? default: 10=(%10) it means every approximately 10 step (optional)
+
+        activation_potentiation (list): For deeper PLAN networks, activation function parameters. For more information please run this code: plan.activations_list() default: [None] (optional)
+
+        x_val (list[num]): List of validation data. default: x_train (optional)
+
+        y_val (list[num]): (list[num]): List of target labels. (one hot encoded) default: y_train (optional)
+
+        show_training (bool, str): True or None default: None (optional)
+
+        LTD (int): Long Term Depression Hyperparameter for train PLAN neural network default: 0 (optional)
+
+        interval (float, int): frame delay (milisecond) parameter for Training Report (show_training=True) This parameter effects to your Training Report performance. Lower value is more diffucult for Low end PC's (33.33 = 30 FPS, 16.67 = 60 FPS) default: 100 (optional)
+
+        decision_boundary_status (bool): If the visualization of validation and training history is enabled during training, should the decision boundaries also be visualized? True or False. Default is True. (optional)
+
+        train_bar (bool): Training loading bar? True or False. Default is True. (optional)
+
+        auto_normalization(bool): Normalization process during training. May effect training time and model quality. True or False. Default is True. (optional)
+
+        neurons_history (bool, optional): Shows the history of changes that neurons undergo during the CL (Cumulative Learning) stages. True or False. Default is False. (optional)
+
+        dtype (numpy.dtype): Data type for the arrays. np.float32 by default. Example: np.float64 or np.float16. [fp32 for balanced devices, fp64 for strong devices, fp16 for weak devices: not reccomended!] (optional)
+
+    Returns:
+        numpyarray([num]): (Weight matrix).
+    """
+
+    # Pre-checks
+
+    x_train = x_train.astype(dtype, copy=False)
+
+    if train_bar and val:
+        train_progress = initialize_loading_bar(total=len(x_train), ncols=71, desc='Fitting', bar_format=bar_format_normal)
+    elif train_bar and val == False:
+        train_progress = initialize_loading_bar(total=len(x_train), ncols=44, desc='Fitting', bar_format=bar_format_normal)
+
+    if len(x_train) != len(y_train):
+        raise ValueError("x_train and y_train must have the same length.")
+
+    if val and (x_val is None and y_val is None):
+        x_val, y_val = x_train, y_train
+
+    elif val and (x_val is not None and y_val is not None):
+        x_val = x_val.astype(dtype, copy=False)
+        y_val = y_val.astype(dtype, copy=False)
+
+    val_list = [] if val else None
+    val_count = val_count or 10
+    # Defining weights
+    STPW = np.ones((len(y_train[0]), len(x_train[0].ravel()))).astype(dtype, copy=False)  # STPW = SHORT TIME POTENTIATION WEIGHT
+    LTPW = np.zeros((len(y_train[0]), len(x_train[0].ravel()))).astype(dtype, copy=False)  # LTPW = LONG TIME POTENTIATION WEIGHT
+    # Initialize visualization
+    vis_objects = initialize_visualization_for_fit(val, show_training, neurons_history, x_train, y_train)
+
+    # Training process
+    for index, inp in enumerate(x_train):
+        inp = np.array(inp, copy=False).ravel()
+        y_decoded = decode_one_hot(y_train)
+        # Weight updates
+        STPW = feed_forward(inp, STPW, is_training=True, Class=y_decoded[index], activation_potentiation=activation_potentiation, LTD=LTD)
+        LTPW += normalization(STPW, dtype=dtype) if auto_normalization else STPW
+        if val and index != 0:
+            if index % math.ceil((val_count / len(x_train)) * 100) == 0:
+                val_acc = evaluate(x_val, y_val, loading_bar_status=False, activation_potentiation=activation_potentiation, W=LTPW)[get_acc()]
+                val_list.append(val_acc)
+
+                # Visualization updates
+                if show_training:
+                    update_weight_visualization_for_fit(vis_objects['ax'][0, 0], LTPW, vis_objects['artist2'])
+                    if decision_boundary_status:
+                        update_decision_boundary_for_fit(vis_objects['ax'][0, 1], x_val, y_val, activation_potentiation, LTPW, vis_objects['artist1'])
+                    update_validation_history_for_fit(vis_objects['ax'][1, 1], val_list, vis_objects['artist3'])
+                    update_neural_web_for_fit(W=LTPW, G=vis_objects['G'], ax=vis_objects['ax'][1, 0], artist=vis_objects['artist4'])
+                if neurons_history:
+                    update_neuron_history(LTPW, row=vis_objects['row'], col=vis_objects['col'], class_count=len(y_train[0]), fig1=vis_objects['fig1'], ax1=vis_objects['ax1'], artist5=vis_objects['artist5'], acc=val_acc)
+        if train_bar:
+             train_progress.update(1)
+
+        STPW = np.ones((len(y_train[0]), len(x_train[0].ravel()))).astype(dtype, copy=False)
+
+    # Finalize visualization
+    if show_training:
+        ani1 = display_visualization_for_fit(vis_objects['fig'], vis_objects['artist1'], interval)
+        ani2 = display_visualization_for_fit(vis_objects['fig'], vis_objects['artist2'], interval)
+        ani3 = display_visualization_for_fit(vis_objects['fig'], vis_objects['artist3'], interval)
+        ani4 = display_visualization_for_fit(vis_objects['fig'], vis_objects['artist4'], interval)
+        show()
+    
+    if neurons_history:
+        ani5 = display_visualization_for_fit(vis_objects['fig1'], vis_objects['artist5'], interval)
+        show()
+
+    return normalization(LTPW, dtype=dtype)
+
+
+def learner(x_train, y_train, optimizer, x_test=None, y_test=None, strategy='accuracy', gen=None, batch_size=1,
+           neural_web_history=False, show_current_activations=False, auto_normalization=True,
+           neurons_history=False, early_stop=False, loss='categorical_crossentropy', show_history=False,
+           interval=33.33, target_acc=None, target_loss=None, except_this=None,
+           only_this=None, start_this_act=None, start_this_W=None, target_fitness='max', dtype=np.float32):
+    """
+    Optimizes the activation functions for a neural network by leveraging train data to find 
+    the most accurate combination of activation potentiation for the given dataset using genetic algorithm NEAT (Neuroevolution of Augmenting Topologies). But modifided for PLAN version. Created by me: PLANEAT. 
+    
+    Why genetic optimization and not backpropagation?
+    Because PLAN is different from other neural network architectures. In PLAN, the learnable parameters are not the weights; instead, the learnable parameters are the activation functions.
+    Since activation functions are not differentiable, we cannot use gradient descent or backpropagation. However, I developed a more powerful genetic optimization algorithm: PLANEAT.
+
+    Args:
+
+        x_train (array-like): Training input data.
+
+        y_train (array-like): Labels for training data. one-hot encoded.
+
+        optimizer (function): PLAN optimization technique with hyperparameters. (PLAN using NEAT(PLANEAT) for optimization.) Please use this: from pyerualjetwork import planeat (and) optimizer = lambda *args, **kwargs: planeat.evolve(*args, 'here give your neat hyperparameters for example:  activation_add_prob=0.85', **kwargs) Example:
+        ```python
+        genetic_optimizer = lambda *args, **kwargs: planeat.evolve(*args,
+                                                                    activation_add_prob=0.85,
+                                                                    mutations=False,
+                                                                    strategy='cross_over',
+                                                                    **kwargs)
+
+        model = plan.learner(x_train,
+                             y_train,
+                             optimizer=genetic_optimizer,
+                             strategy='accuracy',
+                             show_history=True,
+                             target_acc=0.94,
+                             interval=16.67)
+        ```
+
+        x_test (array-like, optional): Test input data (for improve next gen generilization). If test data is not given then train feedback learning active
+
+        y_test (array-like, optional): Test Labels (for improve next gen generilization). If test data is not given then train feedback learning active
+
+        strategy (str, optional): Learning strategy. (options: 'accuracy', 'f1', 'precision', 'recall'): 'accuracy', Maximizes train (or test if given) accuracy during learning. 'f1', Maximizes train (or test if given) f1 score during learning. 'precision', Maximizes train (or test if given) precision score during learning. 'recall', Maximizes train (or test if given) recall during learning. Default is 'accuracy'.
+
+        gen (int, optional): The generation count for genetic optimization.
+
+        batch_size (float, optional): Batch size is used in the prediction process to receive test feedback by dividing the test data into chunks and selecting activations based on randomly chosen partitions. This process reduces computational cost and time while still covering the entire test set due to random selection, so it doesn't significantly impact accuracy. For example, a batch size of 0.08 means each test batch represents 8% of the test set. Default is 1. (%100 of test)
+
+        auto_normalization (bool, optional): If auto normalization=False this makes more faster training times and much better accuracy performance for some datasets. Default is True.
+
+        early_stop (bool, optional): If True, implements early stopping during training.(If test accuracy not improves in two gen stops learning.) Default is False.
+
+        show_current_activations (bool, optional): Should it display the activations selected according to the current strategies during learning, or not? (True or False) This can be very useful if you want to cancel the learning process and resume from where you left off later. After canceling, you will need to view the live training activations in order to choose the activations to be given to the 'start_this' parameter. Default is False
+
+        show_history (bool, optional): If True, displays the training history after optimization. Default is False.
+
+        loss (str, optional): For visualizing and monitoring. PLAN neural networks doesn't need any loss function in training. options: ('categorical_crossentropy' or 'binary_crossentropy') Default is 'categorical_crossentropy'.
+
+        interval (int, optional): The interval at which evaluations are conducted during training. (33.33 = 30 FPS, 16.67 = 60 FPS) Default is 100.
+
+        target_acc (int, optional): The target accuracy to stop training early when achieved. Default is None.
+
+        target_loss (float, optional): The target loss to stop training early when achieved. Default is None.
+
+        except_this (list, optional): A list of activations to exclude from optimization. Default is None. (For avaliable activation functions, run this code: plan.activations_list())
+
+        only_this (list, optional): A list of activations to focus on during optimization. Default is None. (For avaliable activation functions, run this code: plan.activations_list())
+        
+        start_this_act (list, optional): To resume a previously canceled or interrupted training from where it left off, or to continue from that point with a different strategy, provide the list of activation functions selected up to the learned portion to this parameter. Default is None
+
+        start_this_W (numpy.array, optional): To resume a previously canceled or interrupted training from where it left off, or to continue from that point with a different strategy, provide the weight matrix of this genome. Default is None
+
+        neurons_history (bool, optional): Shows the history of changes that neurons undergo during the TFL (Test or Train Feedback Learning) stages. True or False. Default is False.
+
+        neural_web_history (bool, optional): Draws history of neural web. Default is False.
+
+        target_fitness (str, optional): Target fitness strategy for PLANEAT optimization. ('max' for machine learning, 'min' for machine unlearning.) Default: 'max'
+        
+        dtype (numpy.dtype): Data type for the arrays. np.float32 by default. Example: np.float64 or np.float16. [fp32 for balanced devices, fp64 for strong devices, fp16 for weak devices: not reccomended!] (optional)
+
+    Returns:
+        tuple: A list for model parameters: [Weight matrix, Test loss, Test Accuracy, [Activations functions]].
+    
+    """
+
+    print(Fore.WHITE + "\nRemember, optimization on large datasets can be very time-consuming and computationally expensive. Therefore, if you are working with such a dataset, our recommendation is to include activation function: ['circular', 'spiral'] in the 'except_this' parameter unless absolutely necessary, as they can significantly prolong the process. from: learner\n" + Fore.RESET)
+
+    activation_potentiation = all_activations()
+
+    # Pre-checks
+
+    x_train = x_train.astype(dtype, copy=False)
+    y_train = optimize_labels(y_train, cuda=False)
+
+    if x_test is None and y_test is None:
+        x_test = x_train
+        y_test = y_train
+        data = 'Train'
+    else:
+        x_test = x_test.astype(dtype, copy=False)
+        y_test = optimize_labels(y_test, cuda=False)
+        data = 'Test'
+
+    # Filter activation functions
+    if only_this is not None:
+        activation_potentiation = only_this
+    if except_this is not None:
+        activation_potentiation = [item for item in activation_potentiation if item not in except_this]
+    if gen is None:
+        gen = len(activation_potentiation)
+
+    if strategy != 'accuracy' and strategy != 'f1' and strategy != 'recall' and strategy != 'precision': raise ValueError("Strategy parameter only be 'accuracy' or 'f1' or 'recall' or 'precision'.")
+
+    if start_this_act is None and len(activation_potentiation) % 2 != 0: raise ValueError("Activation length must be even number. Please use 'except_this' parameter and except some activation. For example: except_this=['linear']")
+    if start_this_act is not None and len(activation_potentiation) + 1 % 2 != 0: raise ValueError("You are using start_this parameter, activation length still must be even number. Please use 'except_this' parameter and except some activation. For example: except_this=['linear']")
+    
+    # Initialize visualization components
+    viz_objects = initialize_visualization_for_learner(show_history, neurons_history, neural_web_history, x_train, y_train)
+
+    # Initialize progress bar
+    if batch_size == 1:
+        ncols = 76
+    else:
+        ncols = 89
+
+    # Initialize variables
+    act_pop = []
+    weight_pop = []
+    
+    if start_this_act is None and start_this_W is None:
+        best_acc = 0
+    else:
+        act_pop.append(start_this_act)
+        weight_pop.append(start_this_W)
+        
+        x_test_batch, y_test_batch = batcher(x_test, y_test, batch_size=batch_size)
+
+        model = evaluate(x_test_batch, y_test_batch, W=start_this_W, loading_bar_status=False, activation_potentiation=act_pop, dtype=dtype)
+
+        if loss == 'categorical_crossentropy':
+            test_loss = categorical_crossentropy(y_true_batch=y_test_batch, y_pred_batch=model[get_preds_softmax()])
+        else:
+            test_loss = binary_crossentropy(y_true_batch=y_test_batch, y_pred_batch=model[get_preds_softmax()])
+
+        best_acc = model[get_acc()]
+        best_loss = test_loss
+
+    best_acc_per_gen_list = []
+    postfix_dict = {}
+    loss_list = []
+    target_pop = []
+
+    progress = initialize_loading_bar(total=len(activation_potentiation), desc="", ncols=ncols, bar_format=bar_format_learner)
+
+    for i in range(gen):
+        postfix_dict["Gen"] = str(i+1) + '/' + str(gen)
+        progress.set_postfix(postfix_dict)
+
+        progress.n = 0
+        progress.last_print_n = 0
+        progress.update(0)
+
+        for j in range(len(activation_potentiation)):
+
+            x_test_batch, y_test_batch = batcher(x_test, y_test, batch_size=batch_size)
+            
+            if i == 0:
+                act_pop.append(activation_potentiation[j])
+                W = fit(x_train, y_train, activation_potentiation=act_pop[-1], train_bar=False, auto_normalization=auto_normalization, dtype=dtype)
+                weight_pop.append(W)
+
+            model = evaluate(x_test_batch, y_test_batch, W=weight_pop[j], loading_bar_status=False, activation_potentiation=act_pop[j], dtype=dtype)
+            acc = model[get_acc()]
+            
+            if strategy == 'accuracy': target_pop.append(acc)
+
+            elif strategy == 'f1' or strategy == 'precision' or strategy == 'recall':
+                precision_score, recall_score, f1_score = metrics(y_test_batch, model[get_preds()])
+
+                if strategy == 'precision':
+                    target_pop.append(precision_score)
+
+                    if i == 0 and j == 0:
+                        best_precision = precision_score
+
+                if strategy == 'recall':
+                    target_pop.append(recall_score)
+
+                    if i == 0 and j == 0:
+                        best_recall = recall_score
+
+                if strategy == 'f1':
+                    target_pop.append(f1_score)
+
+                    if i == 0 and j == 0:
+                        best_f1 = f1_score
+
+            if ((strategy == 'accuracy' and acc >= best_acc) or 
+                (strategy == 'f1' and f1_score >= best_f1) or 
+                (strategy == 'precision' and precision_score >= best_precision) or
+                (strategy == 'recall' and recall_score >= best_recall)):
+
+                best_acc = acc
+                best_weights = weight_pop[j]
+                final_activations = act_pop[j]
+                best_model = model
+
+                final_activations = [final_activations[0]] if len(set(final_activations)) == 1 else final_activations # removing if all same
+
+                if batch_size == 1:
+                    postfix_dict[f"{data} Accuracy"] = best_acc
+                else:
+                    postfix_dict[f"{data} Batch Accuracy"] = acc
+                progress.set_postfix(postfix_dict)
+
+                if show_current_activations:
+                    print(f", Current Activations={final_activations}", end='')
+
+                if loss == 'categorical_crossentropy':
+                    test_loss = categorical_crossentropy(y_true_batch=y_test_batch, y_pred_batch=model[get_preds_softmax()])
+                else:
+                    test_loss = binary_crossentropy(y_true_batch=y_test_batch, y_pred_batch=model[get_preds_softmax()])
+
+                if batch_size == 1:
+                    postfix_dict[f"{data} Loss"] = test_loss
+                    best_loss = test_loss
+                else:
+                    postfix_dict[f"{data} Batch Loss"] = test_loss
+                progress.set_postfix(postfix_dict)
+                best_loss = test_loss
+
+                # Update visualizations during training
+                if show_history:
+                    gen_list = range(1, len(best_acc_per_gen_list) + 2)
+                    update_history_plots_for_learner(viz_objects, gen_list, loss_list + [test_loss], 
+                                      best_acc_per_gen_list + [best_acc], x_train, final_activations)
+
+                if neurons_history:
+                    viz_objects['neurons']['artists'] = (
+                        update_neuron_history_for_learner(np.copy(best_weights), viz_objects['neurons']['ax'],
+                                     viz_objects['neurons']['row'], viz_objects['neurons']['col'],
+                                     y_train[0], viz_objects['neurons']['artists'],
+                                     data=data, fig1=viz_objects['neurons']['fig'],
+                                     acc=best_acc, loss=test_loss)
+                    )
+
+                if neural_web_history:
+                    art5_1, art5_2, art5_3 = draw_neural_web(W=best_weights, ax=viz_objects['web']['ax'],
+                                                            G=viz_objects['web']['G'], return_objs=True)
+                    art5_list = [art5_1] + [art5_2] + list(art5_3.values())
+                    viz_objects['web']['artists'].append(art5_list)
+
+                # Check target accuracy
+                if target_acc is not None and best_acc >= target_acc:
+                    progress.close()
+                    train_model = evaluate(x_train, y_train, W=best_weights, loading_bar_status=False, 
+                                        activation_potentiation=final_activations, dtype=dtype)
+
+                    if loss == 'categorical_crossentropy':
+                        train_loss = categorical_crossentropy(y_true_batch=y_train, 
+                                                           y_pred_batch=train_model[get_preds_softmax()])
+                    else:
+                        train_loss = binary_crossentropy(y_true_batch=y_train, 
+                                                       y_pred_batch=train_model[get_preds_softmax()])
+
+                    print('\nActivations: ', final_activations)
+                    print(f'Train Accuracy (%{batch_size * 100} of train samples):', train_model[get_acc()])
+                    print(f'Train Loss (%{batch_size * 100} of train samples): ', train_loss, '\n')
+                    if data == 'Test':
+                        print(f'Test Accuracy (%{batch_size * 100} of test samples): ', best_acc)
+                        print(f'Test Loss (%{batch_size * 100} of test samples): ', best_loss, '\n')
+
+                    # Display final visualizations
+                    display_visualizations_for_learner(viz_objects, best_weights, data, best_acc, 
+                                              test_loss, y_train, interval)
+                    return best_weights, best_model[get_preds()], best_acc, final_activations
+
+                # Check target loss
+                if target_loss is not None and best_loss <= target_loss:
+                    progress.close()
+                    train_model = evaluate(x_train, y_train, W=best_weights, loading_bar_status=False, 
+                                        activation_potentiation=final_activations, dtype=dtype)
+
+                    if loss == 'categorical_crossentropy':
+                        train_loss = categorical_crossentropy(y_true_batch=y_train, 
+                                                           y_pred_batch=train_model[get_preds_softmax()])
+                    else:
+                        train_loss = binary_crossentropy(y_true_batch=y_train, 
+                                                       y_pred_batch=train_model[get_preds_softmax()])
+
+                    print('\nActivations: ', final_activations)
+                    print(f'Train Accuracy (%{batch_size * 100} of train samples):', train_model[get_acc()])
+                    print(f'Train Loss (%{batch_size * 100} of train samples): ', train_loss, '\n')
+                    if data == 'Test':
+                        print(f'Test Accuracy (%{batch_size * 100} of test samples): ', best_acc)
+                        print(f'Test Loss (%{batch_size * 100} of test samples): ', best_loss, '\n')
+
+                    # Display final visualizations
+                    display_visualizations_for_learner(viz_objects, best_weights, data, best_acc, 
+                                              test_loss, y_train, interval)
+                    return best_weights, best_model[get_preds()], best_acc, final_activations
+
+            progress.update(1)
+
+        best_acc_per_gen_list.append(best_acc)
+        loss_list.append(best_loss)
+
+        weight_pop, act_pop = optimizer(np.array(weight_pop, dtype=dtype), act_pop, i, np.array(target_pop, dtype=dtype, copy=False), target_fitness=target_fitness, bar_status=False)
+        target_pop = []
+
+        # Early stopping check
+        if early_stop == True and i > 0:
+            if best_acc_per_gen_list[i] == best_acc_per_gen_list[i-1]:
+                progress.close()
+                train_model = evaluate(x_train, y_train, W=best_weights, loading_bar_status=False, 
+                                    activation_potentiation=final_activations, dtype=dtype)
+
+                if loss == 'categorical_crossentropy':
+                    train_loss = categorical_crossentropy(y_true_batch=y_train, 
+                                                       y_pred_batch=train_model[get_preds_softmax()])
+                else:
+                    train_loss = binary_crossentropy(y_true_batch=y_train, 
+                                                   y_pred_batch=train_model[get_preds_softmax()])
+
+                print('\nActivations: ', final_activations)
+                print(f'Train Accuracy (%{batch_size * 100} of train samples):', train_model[get_acc()])
+                print(f'Train Loss (%{batch_size * 100} of train samples): ', train_loss, '\n')
+                if data == 'Test':
+                    print(f'Test Accuracy (%{batch_size * 100} of test samples): ', best_acc)
+                    print(f'Test Loss (%{batch_size * 100} of test samples): ', best_loss, '\n')
+
+                # Display final visualizations
+                display_visualizations_for_learner(viz_objects, best_weights, data, best_acc, 
+                                          test_loss, y_train, interval)
+                return best_weights, best_model[get_preds()], best_acc, final_activations
+
+    # Final evaluation
+    progress.close()
+    train_model = evaluate(x_train, y_train, W=best_weights, loading_bar_status=False, 
+                        activation_potentiation=final_activations, dtype=dtype)
+
+    if loss == 'categorical_crossentropy':
+        train_loss = categorical_crossentropy(y_true_batch=y_train, y_pred_batch=train_model[get_preds_softmax()])
+    else:
+        train_loss = binary_crossentropy(y_true_batch=y_train, y_pred_batch=train_model[get_preds_softmax()])
+
+    print('\nActivations: ', act_pop[-1])
+    print(f'Train Accuracy (%{batch_size * 100} of train samples):', train_model[get_acc()])
+    print(f'Train Loss (%{batch_size * 100} of train samples): ', train_loss, '\n')
+    if data == 'Test':
+        print(f'Test Accuracy (%{batch_size * 100} of test samples): ', best_acc)
+        print(f'Test Loss (%{batch_size * 100} of test samples): ', best_loss, '\n')
+
+    # Display final visualizations
+    display_visualizations_for_learner(viz_objects, best_weights, data, best_acc, test_loss, y_train, interval)
+    return best_weights, best_model[get_preds()], best_acc, final_activations
+
+
+
+def feed_forward(
+    Input,               # list[num]: Input data.
+    w,                   # num: Weight matrix of the neural network.
+    is_training,        # bool: Flag indicating if the function is called during training (True or False).
+    activation_potentiation,
+    Class='?',               # int: Which class is, if training. # (list): Activation potentiation list for deep PLAN. (optional)
+    LTD=0
+) -> tuple:
+    """
+    Applies feature extraction process to the input data using synaptic potentiation.
+
+    Args:
+        Input (num): Input data.
+        w (num): Weight matrix of the neural network.
+        is_training (bool): Flag indicating if the function is called during training (True or False).
+        Class (int): if is during training then which class(label) ? is isnt then put None.
+        # activation_potentiation (list): ac list for deep PLAN. default: [None] ('linear') (optional)
+
+    Returns:
+        tuple: A tuple (vector) containing the neural layer result and the updated weight matrix.
+        or
+        num: neural network output
+    """
+    
+    Output = apply_activation(Input, activation_potentiation)
+
+    Input = Output
+
+    if is_training == True:
+        
+        for _ in range(LTD):        
+
+            depression_vector = np.random.rand(*Input.shape)
+
+            Input -= depression_vector
+
+        w[Class, :] = Input
+        return w
+
+    else:
+
+        neural_layer = np.dot(w, Input)
+
+        return neural_layer
+
+
+def evaluate(
+    x_test,         # NumPy array: Test input data.
+    y_test,         # NumPy array: Test labels.
+    W,              # List of NumPy arrays: Neural network weight matrices.
+    activation_potentiation=['linear'], # List of activation functions.
+    loading_bar_status=True,  # Optionally show loading bar.
+    show_metrics=None,        # Optionally show metrics.
+    dtype=np.float32
+) -> tuple:
+    """
+    Evaluates the neural network model using the given test data.
+
+    Args:
+        x_test (np.ndarray): Test input data.
+        
+        y_test (np.ndarray): Test labels. one-hot encoded.
+        
+        W (list[np.ndarray]): List of neural network weight matrices.
+        
+        activation_potentiation (list): List of activation functions.
+        
+        loading_bar_status (bool): Option to show a loading bar (optional).
+        
+        show_metrics (bool): Option to show metrics (optional).
+
+        dtype (numpy.dtype): Data type for the arrays. np.float32 by default. Example: np.float64 or np.float16. [fp32 for balanced devices, fp64 for strong devices, fp16 for weak devices: not reccomended!]
+
+    Returns:
+        tuple: Predicted labels, model accuracy, and other evaluation metrics.
+    """
+    # Pre-checks
+
+    x_test = x_test.astype(dtype, copy=False)
+
+    if len(y_test[0]) < 256:
+        if y_test.dtype != np.uint8:
+            y_test = np.array(y_test, copy=False).astype(np.uint8, copy=False)
+    elif len(y_test[0]) <= 32767:
+        if y_test.dtype != np.uint16:
+            y_test = np.array(y_test, copy=False).astype(np.uint16, copy=False)
+    else:
+        if y_test.dtype != np.uint32:
+            y_test = np.array(y_test, copy=False).astype(np.uint32, copy=False)
+
+    predict_probabilitys = np.empty((len(x_test), W.shape[0]), dtype=np.float32)
+    real_classes = np.empty(len(x_test), dtype=np.int32)     
+    predict_classes = np.empty(len(x_test), dtype=np.int32)   
+
+    true_predict = 0
+    acc_list = np.empty(len(x_test), dtype=np.float32)    
+
+    if loading_bar_status:
+        loading_bar = initialize_loading_bar(total=len(x_test), ncols=64, desc='Testing', bar_format=bar_format_normal)
+
+    for inpIndex in range(len(x_test)):
+        Input = x_test[inpIndex].ravel() 
+
+        neural_layer = Input
+
+        neural_layer = feed_forward(neural_layer, np.copy(W), is_training=False, Class='?', activation_potentiation=activation_potentiation)
+
+        predict_probabilitys[inpIndex] = Softmax(neural_layer)
+
+        RealOutput = np.argmax(y_test[inpIndex])
+        real_classes[inpIndex] = RealOutput
+        PredictedOutput = np.argmax(neural_layer)
+        predict_classes[inpIndex] = PredictedOutput
+
+        if RealOutput == PredictedOutput:
+            true_predict += 1
+
+        acc = true_predict / (inpIndex + 1)  
+        acc_list[inpIndex] = acc
+
+        if loading_bar_status:
+            loading_bar.update(1)
+            loading_bar.set_postfix({"Test Accuracy": acc})
+
+    if loading_bar_status:
+        loading_bar.close()
+
+    if show_metrics:
+        # Plot the evaluation metrics
+        plot_evaluate(x_test, y_test, predict_classes, acc_list, W=np.copy(W), activation_potentiation=activation_potentiation)
+
+    return W, predict_classes, acc_list[-1], None, None, predict_probabilitys