comment code

iPDC/inc/Attack_detect.h

@@ -1,9 +0,0 @@
-/* pavan changes */
-#include <gtk/gtk.h>
-/* variables declared of attack_detect function */
-
-/* function declared  */
-gboolean attack_detect_freq(struct data_frame *df);
-gboolean attack_detect_vol(struct data_frame *df);
-gboolean attack_detect_freq_vol(struct data_frame *df);
-/* pavan changes */

iPDC/inc/Dynamic_time_warping.h

@@ -1,5 +1,33 @@
+/* -----------------------------------------------------------------------------
+ * Dynamic_time_warping.h
+ *
+ * iPDC - Phasor Data Concentrator
+ *
+ * Copyright (C) 2022-2023 Nitesh Pandit
+ * Copyright (C) 2022-2023 Kedar V. Khandeparkar
+ * Copyright (C) 2022-2023 Pavan Kumar V Patil
+ * Copyright (C) 2022-2023 Karthik Murakonda
+ *
+ * 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 2
+ * 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, write to the Free Software
+ * Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA  02111-1307, USA.
+ *
+ * Authors:
+ *		M V Karthik <karthik.murakonda14@gmail.com>
+ *		Pavan Kumar V Patil <pavanvpatil01@gmail.com>
+ *
+ * ----------------------------------------------------------------------------- */
 
-/*pavan changes*/
 int DTWfreqDistance(struct data_frame *df);
 
 int DTWvolDistance(struct data_frame *df);

iPDC/inc/Event_detect.h

@@ -0,0 +1,34 @@
+/* -----------------------------------------------------------------------------
+ * Event_detect.h
+ *
+ * iPDC - Phasor Data Concentrator
+ *
+ * Copyright (C) 2022-2023 Nitesh Pandit
+ * Copyright (C) 2022-2023 Kedar V. Khandeparkar
+ * Copyright (C) 2022-2023 Pavan Kumar V Patil
+ * Copyright (C) 2022-2023 Karthik Murakonda
+ *
+ * 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 2
+ * 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, write to the Free Software
+ * Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA  02111-1307, USA.
+ *
+ * Authors:
+ *		M V Karthik <karthik.murakonda14@gmail.com>
+ *		Pavan Kumar V Patil <pavanvpatil01@gmail.com>
+ *
+ * ----------------------------------------------------------------------------- */
+
+#include <gtk/gtk.h>
+gboolean attack_detect_freq(struct data_frame *df);
+gboolean attack_detect_vol(struct data_frame *df);
+gboolean attack_detect_freq_vol(struct data_frame *df);

iPDC/inc/Kmeans.h

@@ -1,10 +1,33 @@
-/*Pavan Changes*/
+/* -----------------------------------------------------------------------------
+ * Kmeans.h
+ *
+ * iPDC - Phasor Data Concentrator
+ *
+ * Copyright (C) 2022-2023 Nitesh Pandit
+ * Copyright (C) 2022-2023 Kedar V. Khandeparkar
+ * Copyright (C) 2022-2023 Pavan Kumar V Patil
+ * Copyright (C) 2022-2023 Karthik Murakonda
+ *
+ * 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 2
+ * 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, write to the Free Software
+ * Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA  02111-1307, USA.
+ *
+ * Authors:
+ *		M V Karthik <karthik.murakonda14@gmail.com>
+ *		Pavan Kumar V Patil <pavanvpatil01@gmail.com>
+ *
+ * ----------------------------------------------------------------------------- */
+
 #include <gtk/gtk.h>
-// intial variables
 
-
-
-//function declaration
 gboolean kmeans(struct data_frame *df);
-
-/*Pavan Changes*/

iPDC/inc/Kmeans2.h

@@ -1,3 +1,33 @@
+/* -----------------------------------------------------------------------------
+ * Kmeans2.h
+ *
+ * iPDC - Phasor Data Concentrator
+ *
+ * Copyright (C) 2022-2023 Nitesh Pandit
+ * Copyright (C) 2022-2023 Kedar V. Khandeparkar
+ * Copyright (C) 2022-2023 Pavan Kumar V Patil
+ * Copyright (C) 2022-2023 Karthik Murakonda
+ *
+ * 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 2
+ * 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, write to the Free Software
+ * Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA  02111-1307, USA.
+ *
+ * Authors:
+ *		M V Karthik <karthik.murakonda14@gmail.com>
+ *		Pavan Kumar V Patil <pavanvpatil01@gmail.com>
+ *
+ * ----------------------------------------------------------------------------- */
+
 int *getRandoms(int lower, int upper, int count);
 long double distance(struct Point *A, struct Point *B);
 bool Kmeans2(struct data_frame *df);

iPDC/inc/data_vis.h

@@ -1,8 +1,39 @@
-#include<gtk/gtk.h>
+/* -----------------------------------------------------------------------------
-#include<osm-gps-map.h>
+ * data_vis.h
+ *
+ * iPDC - Phasor Data Concentrator
+ *
+ * Copyright (C) 2022-2023 Nitesh Pandit
+ * Copyright (C) 2022-2023 Kedar V. Khandeparkar
+ * Copyright (C) 2022-2023 Pavan Kumar V Patil
+ * Copyright (C) 2022-2023 Karthik Murakonda
+ *
+ * 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 2
+ * 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, write to the Free Software
+ * Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA  02111-1307, USA.
+ *
+ * Authors:
+ *		M V Karthik <karthik.murakonda14@gmail.com>
+ *		Pavan Kumar V Patil <pavanvpatil01@gmail.com>
+ *
+ * ----------------------------------------------------------------------------- */
+
+#include <gtk/gtk.h>
+#include <osm-gps-map.h>
 #include "livechart.h"
 
-typedef struct{
+typedef struct
+{
     OsmGpsMap *util_map;
     GdkPixbuf *g_red_image;
     GdkPixbuf *g_green_image;
@@ -10,7 +41,8 @@ typedef struct{
     int current_selection;
 } myParameters;
 
-struct vis_data{
+struct vis_data
+{
     int id;
     float lat;
     float lon;
@@ -25,4 +57,4 @@ struct vis_data{
 
 struct vis_data *vis_data_head;
 
-gboolean update_vis(gpointer* pars);
+gboolean update_vis(gpointer *pars);

iPDC/inc/utility_tools.h

@@ -1,11 +1,41 @@
+/* -----------------------------------------------------------------------------
+ * utility_tools.h
+ *
+ * iPDC - Phasor Data Concentrator
+ *
+ * Copyright (C) 2022-2023 Nitesh Pandit
+ * Copyright (C) 2022-2023 Kedar V. Khandeparkar
+ * Copyright (C) 2022-2023 Pavan Kumar V Patil
+ * Copyright (C) 2022-2023 Karthik Murakonda
+ *
+ * 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 2
+ * 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, write to the Free Software
+ * Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA  02111-1307, USA.
+ *
+ * Authors:
+ *		M V Karthik <karthik.murakonda14@gmail.com>
+ *		Pavan Kumar V Patil <pavanvpatil01@gmail.com>
+ *
+ * ----------------------------------------------------------------------------- */
+
 #include <stdio.h>
-#include<gtk/gtk.h>
+#include <gtk/gtk.h>
 #include "osm-gps-map.h"
 #include "livechart.h"
 
 /* Convenience macros for obtaining objects from UI file */
 #define CH_GET_OBJECT(builder, name, type, data) \
-		data->name = type(gtk_builder_get_object (builder, #name) )
+	data->name = type(gtk_builder_get_object(builder, #name))
 #define CH_GET_WIDGET(builder, name, data) \
 	CH_GET_OBJECT(builder, name, GTK_WIDGET, data)
 
@@ -31,10 +61,10 @@ struct _UtData
 	GtkContainer *graph_layoutdfreq;
 	GtkLabel *algo_label;
 	GtkLabel *dimm_label;
-	GtkBox * ml_vol;
+	GtkBox *ml_vol;
-	GtkBox * ml_freq;
+	GtkBox *ml_freq;
-	GtkBox * ml_dfreq;
+	GtkBox *ml_dfreq;
-	GtkBox * ml_ad;
+	GtkBox *ml_ad;
 	GtkWidget *swvol;
 	GtkWidget *swfreq;
 	GtkWidget *swdfreq;
@@ -53,6 +83,4 @@ int curr_measurement;
 int algorithm;
 int dimmension;
 
-
-
 void utility_tools(GtkButton *but, gpointer udata);

iPDC/src/Dynamic_time_warping.c

@@ -1,3 +1,31 @@
+/* -----------------------------------------------------------------------------
+ * Dynamic_time_warping.c
+ *
+ * iPDC - Phasor Data Concentrator
+ *
+ * Copyright (C) 2022-2023 Nitesh Pandit
+ * Copyright (C) 2022-2023 Kedar V. Khandeparkar
+ *
+ * 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 2
+ * 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, write to the Free Software
+ * Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA  02111-1307, USA.
+ *
+ * Authors:
+ *		M V Karthik <karthik.murakonda14@gmail.com>
+ *		Pavan Kumar V Patil <pavanvpatil01@gmail.com>
+ *
+ * ----------------------------------------------------------------------------- */
+
 #include "parser.h"
 #include <stdio.h>
 #include <math.h>
@@ -32,6 +60,13 @@ struct DTWvollist
 struct DTWfreqlist *dtwhead = NULL;
 struct DTWvollist *dtwheadvol = NULL;
 
+/**
+ * @brief It is used to check event detection using Dynamic Time Warping using frequency
+ *        called in data_vis.c
+ *
+ * @param df data frame
+ * @return int
+ */
 int DTWfreqDistance(struct data_frame *df)
 {
     if (dtwhead == NULL)
@@ -158,6 +193,13 @@ int DTWfreqDistance(struct data_frame *df)
     }
 }
 
+/**
+ * @brief It is used to check event detection using Dynamic Time Warping using voltage
+ *        called in data_vis.c
+ *
+ * @param df data frame
+ * @return int
+ */
 int DTWvolDistance(struct data_frame *df)
 {
     if (dtwheadvol == NULL)
@@ -314,6 +356,13 @@ int DTWvolDistance(struct data_frame *df)
     }
 }
 
+/**
+ * @brief It is used to check event detection using Dynamic Time Warping using frequency and voltage
+ *        called in data_vis.c
+ *
+ * @param df data frame
+ * @return int
+ */
 int DTWfreqvolDistance(struct data_frame *df)
 {
     return DTWfreqDistance(df) && DTWfreqvolDistance(df);

iPDC/src/Event_detect.c

@@ -1,12 +1,42 @@
-/* pavan changes */
+/* -----------------------------------------------------------------------------
+ * Event_detect.c
+ *
+ * iPDC - Phasor Data Concentrator
+ *
+ * Copyright (C) 2022-2023 Nitesh Pandit
+ * Copyright (C) 2022-2023 Kedar V. Khandeparkar
+ * Copyright (C) 2022-2023 Pavan Kumar V Patil
+ * Copyright (C) 2022-2023 Karthik Murakonda
+ *
+ * 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 2
+ * 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, write to the Free Software
+ * Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA  02111-1307, USA.
+ *
+ * Authors:
+ *		M V Karthik <karthik.murakonda14@gmail.com>
+ *		Pavan Kumar V Patil <pavanvpatil01@gmail.com>
+ *
+ * ----------------------------------------------------------------------------- */
+
 #include <time.h>
 #include <stdio.h>
 #include <stdlib.h>
 #include <gtk/gtk.h>
 #include <math.h>
 #include "parser.h"
-#include "Attack_detect.h"
+#include "Event_detect.h"
 
+/*Used in maintaining Nodes for all PMUS*/
 struct freqlist
 {
     int idcode;
@@ -15,6 +45,7 @@ struct freqlist
     struct freqlist *next;
 };
 
+/*Used in maintaining Nodes for all PMUS*/
 struct vollist
 {
     int idcode;
@@ -26,6 +57,13 @@ struct vollist
 struct freqlist *head = NULL;
 struct vollist *headvol = NULL;
 
+/**
+ * @brief It is used to check event detection using Basic appraoch using freq
+ *        called in data_vis.c
+ *
+ * @param df data frame
+ * @return gboolean
+ */
 gboolean attack_detect_freq(struct data_frame *df)
 {
     if (head == NULL)
@@ -95,6 +133,13 @@ gboolean attack_detect_freq(struct data_frame *df)
     }
 }
 
+/**
+ * @brief It is used to check event detection using Basic appraoch using voltage
+ *        called in data_vis.c
+ *
+ * @param df data frame
+ * @return gboolean
+ */
 gboolean attack_detect_vol(struct data_frame *df)
 {
     float CURR_vol;
@@ -194,9 +239,14 @@ gboolean attack_detect_vol(struct data_frame *df)
     }
 }
 
+/**
+ * @brief It is used to check event detection using Basic appraoch using voltage and frequency
+ *        called in data_vis.c
+ *
+ * @param df data frame
+ * @return gboolean
+ */
 gboolean attack_detect_freq_vol(struct data_frame *df)
 {
     return attack_detect_freq(df) && attack_detect_vol(df);
 }
-
-/* pavan changes */

iPDC/src/Kmeans.c

@@ -1,4 +1,32 @@
-/*Pavan Changes*/
+/* -----------------------------------------------------------------------------
+ * Kmeans.c
+ *
+ * iPDC - Phasor Data Concentrator
+ *
+ * Copyright (C) 2022-2023 Nitesh Pandit
+ * Copyright (C) 2022-2023 Kedar V. Khandeparkar
+ * Copyright (C) 2022-2023 Pavan Kumar V Patil
+ * Copyright (C) 2022-2023 Karthik Murakonda
+ *
+ * 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 2
+ * 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, write to the Free Software
+ * Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA  02111-1307, USA.
+ *
+ * Authors:
+ *		M V Karthik <karthik.murakonda14@gmail.com>
+ *		Pavan Kumar V Patil <pavanvpatil01@gmail.com>
+ *
+ * ----------------------------------------------------------------------------- */
 
 #include "parser.h"
 #include <stdlib.h>
@@ -22,6 +50,13 @@ struct kmeans1
 
 struct kmeans1 *headk = NULL;
 
+/**
+ * @brief It is used to check event detection using Kmeans clustering using frequency
+ *        called in data_vis.c
+ *
+ * @param df data frame
+ * @return gboolean
+ */
 gboolean kmeans(struct data_frame *df)
 {
     if (headk == NULL)
@@ -99,5 +134,3 @@ gboolean kmeans(struct data_frame *df)
         }
     }
 }
-
-/*Pavan Changes*/

iPDC/src/Kmeans2.c

@@ -1,3 +1,33 @@
+/* -----------------------------------------------------------------------------
+ * Kmeans2.c
+ *
+ * iPDC - Phasor Data Concentrator
+ *
+ * Copyright (C) 2022-2023 Nitesh Pandit
+ * Copyright (C) 2022-2023 Kedar V. Khandeparkar
+ * Copyright (C) 2022-2023 Pavan Kumar V Patil
+ * Copyright (C) 2022-2023 Karthik Murakonda
+ *
+ * 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 2
+ * 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, write to the Free Software
+ * Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA  02111-1307, USA.
+ *
+ * Authors:
+ *		M V Karthik <karthik.murakonda14@gmail.com>
+ *		Pavan Kumar V Patil <pavanvpatil01@gmail.com>
+ *
+ * ----------------------------------------------------------------------------- */
+
 #include "parser.h"
 #include <stdlib.h>
 #include <stdio.h>
@@ -6,6 +36,7 @@
 #include <string.h>
 #include <stdbool.h>
 
+/*Used for storing points*/
 struct Point
 {
     long double x, y;    // coordinates
@@ -13,6 +44,7 @@ struct Point
     long double minDist; // default infinite dist to nearest cluster
 };
 
+/*used for storing centroid of clusters formed*/
 struct centroid
 {
     long double x, y;
@@ -20,6 +52,7 @@ struct centroid
     unsigned long long int count;
 };
 
+/*used to maintain nodes for all PMUs*/
 struct Kmeans2
 {
     int idcode;
@@ -34,11 +67,23 @@ struct Kmeans2
 
 struct Kmeans2 *head_of_kmeans2 = NULL;
 
+/**
+ * @brief It finds data between point A and B
+ *
+ * @param  A,B
+ * @return long double
+ */
 long double distance(struct Point *A, struct Point *B)
 {
     return (((A->x - B->x) * (A->x - B->x)) + ((A->y - B->y) * (A->y - B->y)));
 }
 
+/**
+ * @brief It finds data between centroid A and point B
+ *
+ * @param  A,B
+ * @return long double
+ */
 long double distance2(struct centroid *A, struct Point *B)
 {
     return (((A->x - B->x) * (A->x - B->x)) + ((A->y - B->y) * (A->y - B->y)));
@@ -79,6 +124,13 @@ int *getRandoms(int lower, int upper, int count)
     }
 }
 
+/**
+ * @brief It is used to check event detection using Kmeans clustering using voltage and frequency
+ *        called in data_vis.c
+ *
+ * @param df data frame
+ * @return bool
+ */
 bool Kmeans2(struct data_frame *df)
 {
     if (head_of_kmeans2 == NULL)

iPDC/src/data_vis.c

@@ -1,3 +1,33 @@
+/* -----------------------------------------------------------------------------
+ * data_vis.c
+ *
+ * iPDC - Phasor Data Concentrator
+ *
+ * Copyright (C) 2022-2023 Nitesh Pandit
+ * Copyright (C) 2022-2023 Kedar V. Khandeparkar
+ * Copyright (C) 2022-2023 Pavan Kumar V Patil
+ * Copyright (C) 2022-2023 Karthik Murakonda
+ *
+ * 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 2
+ * 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, write to the Free Software
+ * Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA  02111-1307, USA.
+ *
+ * Authors:
+ *		M V Karthik <karthik.murakonda14@gmail.com>
+ *		Pavan Kumar V Patil <pavanvpatil01@gmail.com>
+ *
+ * ----------------------------------------------------------------------------- */
+
 #include <stdlib.h>
 #include <stdio.h>
 #include <stdbool.h>
@@ -8,7 +38,7 @@
 #include "data_vis.h"
 #include "parser.h"
 #include "osm-gps-map.h"
-#include "Attack_detect.h"
+#include "Event_detect.h"
 #include "Kmeans.h"
 #include "Dynamic_time_warping.h"
 #include "connections.h"
@@ -16,68 +46,86 @@
 #include "utility_tools.h"
 #include "Kmeans2.h"
 
-
 int loops = 0;
 
-gboolean update_vis(gpointer* pars){
+/**
-    int match=0,id, cfg_match=0;
+ * @brief It is used to update the data in the GUI.
-    myParameters* parameters = (myParameters*) pars;
+ *        called in utility_tools.c with the help of g_timeout_add()
-    struct cfg_frame* temp_cfg;
+ * 
+ * @param pars 
+ * @return gboolean 
+ */
+gboolean update_vis(gpointer *pars)
+{
+    int match = 0, id, cfg_match = 0;
+    myParameters *parameters = (myParameters *)pars;
+    struct cfg_frame *temp_cfg;
 
     pthread_mutex_lock(&mutex_on_TSB);
-    struct data_frame *df = TSB[MAXTSB-1].first_data_frame;
+    struct data_frame *df = TSB[MAXTSB - 1].first_data_frame;
     struct Lower_Layer_Details *LLptr;
     struct vis_data *vis_ptr;
 
-    if (df == NULL){
+    if (df == NULL)
+    {
         pthread_mutex_unlock(&mutex_on_TSB);
         return TRUE;
     }
 
     int i = 0, k = 0;
-    float freq,vol_magnitude,angle, dfreq;
+    float freq, vol_magnitude, angle, dfreq;
     unsigned char freq_fmt, anal_fmt, phas_fmt, polar_fmt;
-    while (df!=NULL){
+    while (df != NULL)
+    {
         float lat;
         float lon;
         loops++;
         id = to_intconvertor(df->idcode);
         pthread_mutex_lock(&mutex_cfg);
         temp_cfg = cfgfirst;
-        while(temp_cfg != NULL){
+        while (temp_cfg != NULL)
-            if(id == to_intconvertor(temp_cfg->idcode)){
+        {
+            if (id == to_intconvertor(temp_cfg->idcode))
+            {
                 cfg_match = 1;
                 freq_fmt = temp_cfg->pmu[0]->fmt->freq;
                 anal_fmt = temp_cfg->pmu[0]->fmt->analog;
                 phas_fmt = temp_cfg->pmu[0]->fmt->phasor;
                 polar_fmt = temp_cfg->pmu[0]->fmt->polar;
                 break;
-            } else {
+            }
+            else
+            {
                 temp_cfg = temp_cfg->cfgnext;
             }
         }
         pthread_mutex_unlock(&mutex_cfg);
 
         // get data from df.
-        if(freq_fmt == '1'){
+        if (freq_fmt == '1')
+        {
             freq = decode_ieee_single(df->dpmu[i]->freq);
-            printf("freq = %f\n",freq);
+            printf("freq = %f\n", freq);
-        }else{
+        }
-            freq = to_intconvertor(df->dpmu[i]->freq)*1e-3+50;
+        else
-            printf("freq = %f\n",freq);
+        {
+            freq = to_intconvertor(df->dpmu[i]->freq) * 1e-3 + 50;
+            printf("freq = %f\n", freq);
         }
 
         unsigned char first2bytes[2];
         strncpy(first2bytes, df->dpmu[i]->phasors[0], 2);
         unsigned char last2bytes[2];
-        strncpy(last2bytes, df->dpmu[i]->phasors[0]+2, 2);
+        strncpy(last2bytes, df->dpmu[i]->phasors[0] + 2, 2);
         vol_magnitude = to_intconvertor(first2bytes);
         float imaginary = to_intconvertor(last2bytes);
 
         vis_ptr = vis_data_head;
         match = 0;
-        while(vis_ptr != NULL){
+        while (vis_ptr != NULL)
-            if(vis_ptr->id == id){
+        {
+            if (vis_ptr->id == id)
+            {
                 match = 1;
                 break;
             }
@@ -91,79 +139,137 @@ gboolean update_vis(gpointer* pars){
         live_chart_serie_add(vis_ptr->serie_vol, vol_magnitude);
         live_chart_serie_add(vis_ptr->serie_dfreq, dfreq);
 
-        if(match == 1 && cfg_match == 1){
+        if (match == 1 && cfg_match == 1)
-            if(vis_ptr->last_image != 0){
+        {
+            if (vis_ptr->last_image != 0)
+            {
                 osm_gps_map_image_remove(parameters->util_map, vis_ptr->last_image);
             }
 
-            if(curr_measurement == 0){
+            if (curr_measurement == 0)
-                if(vol_magnitude > 65600 || vol_magnitude < 65300){
+            {
+                if (vol_magnitude > 65600 || vol_magnitude < 65300)
+                {
                     vis_ptr->last_image = osm_gps_map_image_add(parameters->util_map, lat, lon, parameters->g_red_image);
-                }else{
+                }
+                else
+                {
                     vis_ptr->last_image = osm_gps_map_image_add(parameters->util_map, lat, lon, parameters->g_green_image);
                 }
-            }else if(curr_measurement == 1){
-                if (freq > 50.3){
-                    vis_ptr->last_image = osm_gps_map_image_add(parameters->util_map,lat, lon, parameters->g_green_image);
-                }else{
-                    vis_ptr->last_image = osm_gps_map_image_add(parameters->util_map,lat, lon, parameters->g_red_image);
             }
-            }else if(curr_measurement == 2){
+            else if (curr_measurement == 1)
-                if (dfreq < 0.5){
+            {
-                    vis_ptr->last_image = osm_gps_map_image_add(parameters->util_map,lat, lon, parameters->g_green_image);
+                if (freq > 50.3)
-                }else{
+                {
-                    vis_ptr->last_image = osm_gps_map_image_add(parameters->util_map,lat, lon, parameters->g_red_image);
+                    vis_ptr->last_image = osm_gps_map_image_add(parameters->util_map, lat, lon, parameters->g_green_image);
                 }
-            }else if(curr_measurement == 3){
+                else
-                if(algorithm==0 && dimmension == 0){
+                {
-                    if (!attack_detect_freq(df)){
+                    vis_ptr->last_image = osm_gps_map_image_add(parameters->util_map, lat, lon, parameters->g_red_image);
-                        vis_ptr->last_image = osm_gps_map_image_add(parameters->util_map,lat, lon, parameters->g_red_image);
-                    }else{
-                        vis_ptr->last_image = osm_gps_map_image_add(parameters->util_map,lat, lon, parameters->g_green_image);
                 }
-                }else if (algorithm==0 && dimmension == 1){
-                    if (!attack_detect_vol(df)){
-                        vis_ptr->last_image = osm_gps_map_image_add(parameters->util_map,lat, lon, parameters->g_red_image);
-                    }else{
-                        vis_ptr->last_image = osm_gps_map_image_add(parameters->util_map,lat, lon, parameters->g_green_image);
             }
-                }else if (algorithm==0 && dimmension == 2){
+            else if (curr_measurement == 2)
-                    if (!attack_detect_freq_vol(df)){
+            {
-                        vis_ptr->last_image = osm_gps_map_image_add(parameters->util_map,lat, lon, parameters->g_red_image);
+                if (dfreq < 0.5)
-                    }else{
+                {
-                        vis_ptr->last_image = osm_gps_map_image_add(parameters->util_map,lat, lon, parameters->g_green_image);
+                    vis_ptr->last_image = osm_gps_map_image_add(parameters->util_map, lat, lon, parameters->g_green_image);
                 }
-                }else if (algorithm==1 && dimmension == 0){
+                else
-                    if(!kmeans(df)){
+                {
-                        vis_ptr->last_image = osm_gps_map_image_add(parameters->util_map,lat, lon, parameters->g_red_image);
+                    vis_ptr->last_image = osm_gps_map_image_add(parameters->util_map, lat, lon, parameters->g_red_image);
-                    }else{
-                        vis_ptr->last_image = osm_gps_map_image_add(parameters->util_map,lat, lon, parameters->g_green_image);
                 }
-                }else if (algorithm==1 && dimmension == 1){
-
-                }else if (algorithm==1 && dimmension == 2){
-                    if(!Kmeans2(df)){
-                        vis_ptr->last_image = osm_gps_map_image_add(parameters->util_map,lat, lon, parameters->g_red_image);
-                    }else{
-                        vis_ptr->last_image = osm_gps_map_image_add(parameters->util_map,lat, lon, parameters->g_green_image);
             }
-                }else if (algorithm==2 && dimmension == 0){
+            else if (curr_measurement == 3)
-                    if(!DTWfreqDistance(df)){
+            {
-                        vis_ptr->last_image = osm_gps_map_image_add(parameters->util_map,lat, lon, parameters->g_red_image);
+                if (algorithm == 0 && dimmension == 0)
-                    }else{
+                {
-                        vis_ptr->last_image = osm_gps_map_image_add(parameters->util_map,lat, lon, parameters->g_green_image);
+                    if (!attack_detect_freq(df))
+                    {
+                        vis_ptr->last_image = osm_gps_map_image_add(parameters->util_map, lat, lon, parameters->g_red_image);
                     }
-                }else if (algorithm==2 && dimmension == 1){
+                    else
-                    if(!DTWvolDistance(df)){
+                    {
-                        vis_ptr->last_image = osm_gps_map_image_add(parameters->util_map,lat, lon, parameters->g_red_image);
+                        vis_ptr->last_image = osm_gps_map_image_add(parameters->util_map, lat, lon, parameters->g_green_image);
-                    }else{
-                        vis_ptr->last_image = osm_gps_map_image_add(parameters->util_map,lat, lon, parameters->g_green_image);
                     }
-                }else if (algorithm==2 && dimmension == 2){
+                }
-                    if(!DTWfreqvolDistance(df)){
+                else if (algorithm == 0 && dimmension == 1)
-                        vis_ptr->last_image = osm_gps_map_image_add(parameters->util_map,lat, lon, parameters->g_red_image);
+                {
-                    }else{
+                    if (!attack_detect_vol(df))
-                        vis_ptr->last_image = osm_gps_map_image_add(parameters->util_map,lat, lon, parameters->g_green_image);
+                    {
+                        vis_ptr->last_image = osm_gps_map_image_add(parameters->util_map, lat, lon, parameters->g_red_image);
+                    }
+                    else
+                    {
+                        vis_ptr->last_image = osm_gps_map_image_add(parameters->util_map, lat, lon, parameters->g_green_image);
+                    }
+                }
+                else if (algorithm == 0 && dimmension == 2)
+                {
+                    if (!attack_detect_freq_vol(df))
+                    {
+                        vis_ptr->last_image = osm_gps_map_image_add(parameters->util_map, lat, lon, parameters->g_red_image);
+                    }
+                    else
+                    {
+                        vis_ptr->last_image = osm_gps_map_image_add(parameters->util_map, lat, lon, parameters->g_green_image);
+                    }
+                }
+                else if (algorithm == 1 && dimmension == 0)
+                {
+                    if (!kmeans(df))
+                    {
+                        vis_ptr->last_image = osm_gps_map_image_add(parameters->util_map, lat, lon, parameters->g_red_image);
+                    }
+                    else
+                    {
+                        vis_ptr->last_image = osm_gps_map_image_add(parameters->util_map, lat, lon, parameters->g_green_image);
+                    }
+                }
+                else if (algorithm == 1 && dimmension == 1)
+                {
+                }
+                else if (algorithm == 1 && dimmension == 2)
+                {
+                    if (!Kmeans2(df))
+                    {
+                        vis_ptr->last_image = osm_gps_map_image_add(parameters->util_map, lat, lon, parameters->g_red_image);
+                    }
+                    else
+                    {
+                        vis_ptr->last_image = osm_gps_map_image_add(parameters->util_map, lat, lon, parameters->g_green_image);
+                    }
+                }
+                else if (algorithm == 2 && dimmension == 0)
+                {
+                    if (!DTWfreqDistance(df))
+                    {
+                        vis_ptr->last_image = osm_gps_map_image_add(parameters->util_map, lat, lon, parameters->g_red_image);
+                    }
+                    else
+                    {
+                        vis_ptr->last_image = osm_gps_map_image_add(parameters->util_map, lat, lon, parameters->g_green_image);
+                    }
+                }
+                else if (algorithm == 2 && dimmension == 1)
+                {
+                    if (!DTWvolDistance(df))
+                    {
+                        vis_ptr->last_image = osm_gps_map_image_add(parameters->util_map, lat, lon, parameters->g_red_image);
+                    }
+                    else
+                    {
+                        vis_ptr->last_image = osm_gps_map_image_add(parameters->util_map, lat, lon, parameters->g_green_image);
+                    }
+                }
+                else if (algorithm == 2 && dimmension == 2)
+                {
+                    if (!DTWfreqvolDistance(df))
+                    {
+                        vis_ptr->last_image = osm_gps_map_image_add(parameters->util_map, lat, lon, parameters->g_red_image);
+                    }
+                    else
+                    {
+                        vis_ptr->last_image = osm_gps_map_image_add(parameters->util_map, lat, lon, parameters->g_green_image);
                     }
                 }
             }
@@ -176,4 +282,3 @@ gboolean update_vis(gpointer* pars){
     gtk_widget_queue_draw(GTK_WIDGET(parameters->util_map));
     return TRUE;
 }
- 

iPDC/src/utility_tools.c

@@ -1,3 +1,33 @@
+/* -----------------------------------------------------------------------------
+ * utility_tools.c
+ *
+ * iPDC - Phasor Data Concentrator
+ *
+ * Copyright (C) 2022-2023 Nitesh Pandit
+ * Copyright (C) 2022-2023 Kedar V. Khandeparkar
+ * Copyright (C) 2022-2023 Pavan Kumar V Patil
+ * Copyright (C) 2022-2023 Karthik Murakonda
+ * 
+ * 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 2
+ * 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, write to the Free Software
+ * Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA  02111-1307, USA.
+ *
+ * Authors:
+ *		M V Karthik <karthik.murakonda14@gmail.com>
+ *		Pavan Kumar V Patil <pavanvpatil01@gmail.com>
+ *
+ * ----------------------------------------------------------------------------- */
+
 #include <gtk/gtk.h>
 #include "align_sort.h"
 #include "parser.h"
@@ -14,11 +44,21 @@
 #define GREY_IMAGE "/usr/local/share/iPDC/grey.png"
 #define PINK_IMAGE "/usr/local/share/iPDC/pink.png"
 
+/**
+ * @brief Get the Index Color object
+ * 
+ * @param index 
+ * @return GdkRGBA 
+ * @note This function is used to get the color of the index mathematicallly 
+ * by using the index value.
+ * 
+ */
 
-GdkRGBA getIndexColor(int index){
+GdkRGBA getIndexColor(int index)
+{
     GdkRGBA color;
-    // get the color from the index mathematically
+    switch (index)
-    switch(index){
+    {
     case 0:
         color.red = 1.0;
         color.green = 0.0;
@@ -104,23 +144,27 @@ GdkRGBA getIndexColor(int index){
         color.alpha = 1.0;
         break;
     default:
-            color.red = 0.0+0.1*index;
+        color.red = 0.0 + 0.1 * index;
-            color.green = 0.0+0.9*index;
+        color.green = 0.0 + 0.9 * index;
-            color.blue = 0.0+0.5*index;
+        color.blue = 0.0 + 0.5 * index;
         color.alpha = 1.0;
         break;
     }
     return color;
 }
 
-
 void on_window_destroy(GtkWidget *widget, gpointer data)
 {
     g_source_remove(GPOINTER_TO_UINT(data));
     gtk_main_quit();
 }
 
-// on clicking the button voltage
+/**
+ * @brief handles the voltage magnitude button click event
+ * 
+ * @param but 
+ * @param udata 
+ */
 void on_voltage_clicked(GtkButton *but, gpointer udata)
 {
     curr_measurement = 0;
@@ -152,7 +196,12 @@ void on_voltage_clicked(GtkButton *but, gpointer udata)
     printf("Voltage\n");
 }
 
-// on clicking the button frequency
+/**
+ * @brief handles the frequency magnitude button click event
+ * 
+ * @param but : button
+ * @param udata : user data
+ */
 void on_frequency_clicked(GtkButton *but, gpointer udata)
 {
     curr_measurement = 1;
@@ -173,7 +222,6 @@ void on_frequency_clicked(GtkButton *but, gpointer udata)
     gtk_widget_hide(utdata->graph_layoutdfreq);
     gtk_widget_hide(utdata->graph_layoutvol);
 
-
     gtk_widget_hide(utdata->algorithm);
     gtk_widget_hide(utdata->dimmension);
     gtk_widget_hide(utdata->algo_label);
@@ -186,7 +234,12 @@ void on_frequency_clicked(GtkButton *but, gpointer udata)
     printf("Frequency\n");
 }
 
-// on clicking the button dfreq
+/**
+ * @brief handles the frequency derivative button click event
+ * 
+ * @param but : button
+ * @param udata : user data
+ */
 void on_dfreq_clicked(GtkButton *but, gpointer udata)
 {
     curr_measurement = 2;
@@ -207,7 +260,6 @@ void on_dfreq_clicked(GtkButton *but, gpointer udata)
     gtk_widget_hide(utdata->swvol);
     gtk_widget_hide(utdata->swfreq);
 
-
     gtk_widget_hide(utdata->algorithm);
     gtk_widget_hide(utdata->dimmension);
     gtk_widget_hide(utdata->algo_label);
@@ -220,7 +272,12 @@ void on_dfreq_clicked(GtkButton *but, gpointer udata)
     printf("dfreq\n");
 }
 
-// on clicking the button attack_detection
+/**
+ * @brief handles the attack detection button click event
+ * 
+ * @param but : button
+ * @param udata : user data
+ */
 void on_attack_detection_clicked(GtkButton *but, gpointer udata)
 {
     curr_measurement = 3;
@@ -251,12 +308,24 @@ void on_attack_detection_clicked(GtkButton *but, gpointer udata)
     printf("Attack Detection\n");
 }
 
+/**
+ * @brief Set the algo variable to the selected algorithm
+ * 
+ * @param combo : combo box
+ * @param udata : user data
+ */
 void set_algo(GtkComboBox *combo, gpointer udata)
 {
     algorithm = gtk_combo_box_get_active(combo);
     printf("Algorithm: %d\n", algorithm);
 }
 
+/**
+ * @brief Set the dimm variable to the selected dimmension
+ * 
+ * @param combo : combo box
+ * @param udata : user data
+ */
 void set_dimm(GtkComboBox *combo, gpointer udata)
 {
     dimmension = gtk_combo_box_get_active(combo);
@@ -264,9 +333,13 @@ void set_dimm(GtkComboBox *combo, gpointer udata)
     printf("dimmension = %d\n", dimmension);
 }
 
-
+/**
-
+ * @brief Main function for the utility tools window sets up the window and all the widgets
-// Initializes utility tools window.
+ *      and connects the signals to the callbacks.
+ * 
+ * @param but : button
+ * @param udata : user data
+ */
 void utility_tools(GtkButton *but, gpointer udata)
 {
     GdkPixbuf *g_red_image;
@@ -322,7 +395,6 @@ void utility_tools(GtkButton *but, gpointer udata)
     gtk_widget_set_visible(utdata->graph_layoutfreq, FALSE);
     gtk_widget_set_visible(utdata->graph_layoutdfreq, FALSE);
 
-
     g_signal_connect(utdata->voltage, "clicked", G_CALLBACK(on_voltage_clicked), NULL);
     g_signal_connect(utdata->frequency, "clicked", G_CALLBACK(on_frequency_clicked), NULL);
     g_signal_connect(utdata->dfreq, "clicked", G_CALLBACK(on_dfreq_clicked), NULL);
@@ -344,13 +416,12 @@ void utility_tools(GtkButton *but, gpointer udata)
     dimmension = 0;
     myParameters parameters = {utdata->util_map, g_red_image, g_green_image, g_grey_image, g_last_image};
     gpointer data = (gpointer)&parameters;
-    struct cfg_frame* temp_cfg = cfgfirst;
+    struct cfg_frame *temp_cfg = cfgfirst;
 
     gtk_widget_set_size_request(GTK_WIDGET(utdata->util_map), 600, 500);
 
     gtk_container_add(utdata->map_layout, GTK_WIDGET(utdata->util_map));
 
-    
     LiveChartConfig *config_vol = live_chart_config_new();
     live_chart_yaxis_set_unit(config_vol->y_axis, "V");
     live_chart_xaxis_set_tick_interval(config_vol->x_axis, 20);
@@ -369,7 +440,6 @@ void utility_tools(GtkButton *but, gpointer udata)
 
     LiveChartChart *chart_freq = live_chart_chart_new(config_freq);
 
-
     LiveChartConfig *config_dfreq = live_chart_config_new();
     live_chart_yaxis_set_unit(config_dfreq->y_axis, "mHz");
     live_chart_xaxis_set_tick_interval(config_dfreq->x_axis, 20);
@@ -381,7 +451,7 @@ void utility_tools(GtkButton *but, gpointer udata)
 
     struct Lower_Layer_Details *llptr = LLfirst;
     vis_data_head = (struct vis_data *)malloc(sizeof(struct vis_data));
-    struct vis_data * temp_visptr = vis_data_head;
+    struct vis_data *temp_visptr = vis_data_head;
     int index = 0;
     float centroid_latitude = 0;
     float centroid_longitude = 0;
@@ -396,12 +466,11 @@ void utility_tools(GtkButton *but, gpointer udata)
         // declare tooltip
         gchar *tooltiptext;
 
-
         // iterate through the cfg frame and find the corresponding cfg frame
         while (temp_cfg != NULL)
         {
             tooltiptext = g_strdup_printf("unknown");
-            if ( to_intconvertor(temp_cfg->idcode) == llptr->pmuid)
+            if (to_intconvertor(temp_cfg->idcode) == llptr->pmuid)
             {
                 // set the tooltip text
                 tooltiptext = cfgfirst->pmu[0]->stn;
@@ -410,16 +479,16 @@ void utility_tools(GtkButton *but, gpointer udata)
             temp_cfg = temp_cfg->cfgnext;
         }
 
-        temp_visptr->serie_freq = live_chart_serie_new(llptr->ip, (LiveChartSerieRenderer*)live_chart_line_new(live_chart_values_new(10000)));
+        temp_visptr->serie_freq = live_chart_serie_new(llptr->ip, (LiveChartSerieRenderer *)live_chart_line_new(live_chart_values_new(10000)));
         GdkRGBA color = getIndexColor(index);
         live_chart_path_set_color(live_chart_serie_get_line(temp_visptr->serie_freq), &color);
         live_chart_chart_add_serie(chart_freq, temp_visptr->serie_freq);
 
-        temp_visptr->serie_vol = live_chart_serie_new(llptr->ip, (LiveChartSerieRenderer*)live_chart_line_new(live_chart_values_new(10000)));
+        temp_visptr->serie_vol = live_chart_serie_new(llptr->ip, (LiveChartSerieRenderer *)live_chart_line_new(live_chart_values_new(10000)));
         live_chart_path_set_color(live_chart_serie_get_line(temp_visptr->serie_vol), &color);
         live_chart_chart_add_serie(chart_vol, temp_visptr->serie_vol);
 
-        temp_visptr->serie_dfreq = live_chart_serie_new(llptr->ip, (LiveChartSerieRenderer*)live_chart_line_new(live_chart_values_new(10000)));
+        temp_visptr->serie_dfreq = live_chart_serie_new(llptr->ip, (LiveChartSerieRenderer *)live_chart_line_new(live_chart_values_new(10000)));
         live_chart_path_set_color(live_chart_serie_get_line(temp_visptr->serie_dfreq), &color);
         live_chart_chart_add_serie(chart_dfreq, temp_visptr->serie_dfreq);
 
@@ -453,10 +522,13 @@ void utility_tools(GtkButton *but, gpointer udata)
     temp_visptr->next = NULL;
 
     guint pid = g_timeout_add(20, (GSourceFunc)update_vis, data);
-    if(index>0){
+    if (index > 0)
+    {
         centroid_latitude /= (index);
         centroid_longitude /= (index);
-    }else{
+    }
+    else
+    {
         centroid_latitude = 15;
         centroid_longitude = 74;
     }