kitikiplot 0.2.4__py3-none-any.whl → 0.2.6__py3-none-any.whl

kitikiplot/core/kitiki_cell.py

@@ -79,6 +79,8 @@ class KitikiCell(ColorConfig):
                 fallback_hatch: str,
                 display_hatch: bool,
                 transpose: bool,
+                focus,
+                focus_alpha,
                 **kitiki_cell_kwargs: dict) -> mpatches.Rectangle:
         
         """
@@ -142,8 +144,28 @@ class KitikiCell(ColorConfig):
             # Calculate alignment factor based on whether alignment is enabled
             align_factor= (self.rows-x)*self.stride*cell_height if align else 0
 
-            # Calculate dimensions for the rectangle based on grid position and size parameters
-            rect_dim= (window_gap*(x+1)+ cell_width*(x+1) , cell_height*(self.cols-y-1)+align_factor)
+            dim_x= window_gap*(x+1)+ cell_width*(x+1)
+            dim_y= cell_height*(self.cols-y-1)+align_factor
+
+            if focus == None:
+                
+                # Calculate dimensions for the rectangle based on grid position and size parameters
+                rect_dim= ( dim_x, dim_y )
+
+            else:
+
+                align_factor= (self.rows)*self.stride*cell_height
+                focus_dim_y= cell_height*(self.cols-y-1)+align_factor
+
+                # Calculate dimensions for the rectangle based on grid position and size parameters
+                rect_dim= ( dim_x, focus_dim_y )
+
+                max_y= cell_height*(self.cols-1)+ ((self.rows)*self.stride*cell_height)
+
+                if (focus_dim_y >= max_y - (cell_height*self.window_length + cell_height*x*self.stride)) and  (focus_dim_y < max_y - (cell_height*x*self.stride)):
+                    kitiki_cell_kwargs["alpha"]= 1
+                else:
+                    kitiki_cell_kwargs["alpha"]= focus_alpha
 
         # Adjust dimensions if 'transpose' is set to 'True'
         else:
@@ -154,8 +176,11 @@ class KitikiCell(ColorConfig):
             # Calculate alignment factor for transposed configuration based on whether alignment is enabled
             align_factor= x*self.stride*cell_height if align else 0
 
+            dim_x= cell_height*(y+1)+ align_factor
+            dim_y= window_gap*(self.rows- x+1)+ cell_width*(self.rows- x+1)
             # Calculate dimensions for the rectangle based on grid position and size parameters for transposed layout
-            rect_dim= (cell_height*(y+1)+ align_factor, window_gap*(self.rows- x+1)+ cell_width*(self.rows- x+1))
+            rect_dim= (dim_x, dim_y)
+                
 
 
         # Clean up all local variables for efficient memory management

kitikiplot/core/kitiki_color_config.py

@@ -94,14 +94,10 @@ class ColorConfig:
             # Convert 'list' to 'pd.DataFrame' using stride and window_length, and initialize 'data' attribute
             self.data= self._convert_list_to_dataframe( list(data), stride, window_length)
 
-        # Store the stride value
-        self.stride= stride
-
-        # Set 'rows' to number of rows in the DataFrame
         self.rows= self.data.shape[0]
-
-        # Set 'cols' to number of columns in the DataFrame
         self.cols= self.data.shape[1]
+        self.stride= stride
+        self.window_length= window_length
 
     @staticmethod
     def _convert_list_to_dataframe( data: Union[pd.DataFrame, list], stride: int = 1, window_length: int = 10) -> pd.DataFrame:

kitikiplot/core/kitikiplot.py

@@ -8,6 +8,7 @@ Last Modified: 19-02-2025
 
 # Import necessary libraries
 from typing import List, Union
+import numpy as np
 import pandas as pd
 import matplotlib
 import matplotlib.pyplot as plt
@@ -77,6 +78,8 @@ class KitikiPlot(KitikiCell):
               hmap: dict = {},
               fallback_hatch: str = " ",
               display_hatch: bool = False,
+              focus: Union[tuple, list] = None,
+              focus_alpha: float = 0.25,
               transpose: bool = False,
               xlabel: str = "Sliding Windows", 
               ylabel: str = "Frames", 
@@ -143,6 +146,13 @@ class KitikiPlot(KitikiCell):
         display_hatch : bool
             - A flag indicating whether to display hatch patterns on cells.
             - Default is False.
+        focus : tuple or list
+            - Index range to set focus/ highlight
+            - If focus is (i, j) then index values: i, i+1, i+2, ... j-1 are highlighted (0% transparent)
+            - Default is None
+        focus_alpha : float
+            - Transparency value to de-emphasize indices falling out of 'focus'
+            - Default is 0.25
         transpose : bool (optional)
             - A flag indicating whether to transpose the KitikiPlot. 
             - Default is False.
@@ -236,13 +246,24 @@ class KitikiPlot(KitikiCell):
             # This allows for plotting only a subset of the data based on the user-defined range
             window_range= range( window_range[0], window_range[1])
 
+        if focus != None:
+            col_range= self.rows + self.window_length - 1
+            print( "COLUMN Range: ", col_range )
+        else:
+            col_range= self.cols
+
+        each_sample= np.concatenate( (data[0], data[1:data.shape[0], (-1)*self.stride:].flatten()) )
+
         # Generate cells for each sample in the specified window range and time frame columns
         for index in window_range:
 
-            each_sample= data[ index ]
+            if focus == None:
+                each_sample= data[ index ]
 
-            for time_frame in range(self.cols):
+            for time_frame in range( col_range ):
 
+                kitiki_cell_kwargs["alpha"]= focus_alpha if focus != None and ( time_frame< focus[0] or time_frame>= focus[1] ) else 1
+                
                 # Create each cell using specified parameters and add it to patches list 
                 cell_gen= self.create(  x= index,
                                         y= time_frame,
@@ -258,6 +279,8 @@ class KitikiPlot(KitikiCell):
                                         fallback_hatch= fallback_hatch,
                                         display_hatch= display_hatch,
                                         transpose= transpose,
+                                        focus= focus,
+                                        focus_alpha= focus_alpha,
                                         **kitiki_cell_kwargs
                                     )
                 patches.append( cell_gen )

kitikiplot/ecology/linear.py

@@ -0,0 +1,30 @@
+"""
+File Name: linear.py
+Description: This file defines linear concentration plot
+Author: Boddu Sri Pavan
+Date Created: 25-05-2025
+Last Modified: 25-05-2025
+"""
+
+from kitikiplot.core import KitikiPlot
+
+def plot( data, focus, focus_alpha, xlabel, ylabel, xticks_values, ytick_prefix, cmap= {} ):
+
+    ktk= KitikiPlot( data= data, stride= 1, window_length= len(data) )
+
+    ktk.plot(
+            figsize= (20, 1),
+            cell_width= 2,
+            cmap= cmap,
+            focus= focus,
+            focus_alpha= focus_alpha,
+            transpose= True,
+            xlabel= xlabel,
+            ylabel= ylabel,
+            display_xticks= True,
+            xticks_values= xticks_values,
+            ytick_prefix= ytick_prefix,
+            xticks_rotation= 90, 
+            display_legend= True,
+            title= "Linear Plot: Ecology Data Visualization",
+            legend_kwargs= {"bbox_to_anchor": (1.01, 1), "loc":'upper left', "borderaxespad": 0.})

{kitikiplot-0.2.4.dist-info → kitikiplot-0.2.6.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: kitikiplot
-Version: 0.2.4
+Version: 0.2.6
 Summary: A Python library to visualize categorical sliding window data.
 License: MIT
 Keywords: sliding window,sequential,time-series,genome,categorical data
@@ -39,10 +39,8 @@ Description-Content-Type: text/markdown
 KitikiPlot is a Python library for visualizing sequential and time-series categorical "Sliding Window" data. <br>
 (The term 'kitiki' means 'window' in Telugu)
 
-Our preprint is published in **TechRxiv**. Find it <a href="https://www.techrxiv.org/users/877016/articles/1256589-kitikiplot-a-python-library-to-visualize-categorical-sliding-window-data"> here <a/>
+Genome Grid Plot Generator: <a href= "https://huggingface.co/spaces/BodduSriPavan111/genomics">🤗 HuggingFace Demo</a>
 
-Research paper is published in **GIS Science Journal** Volume 12 Issue 1, 186-193, 2025 (Scopus indexed with Impact factor **6.1**). </br>
-Read it here: <a href="https://zenodo.org/records/14632005">https://zenodo.org/records/14632005</a>
 <!--
 ## Table of Contents</h2>
 - [Why Kitkiplot?](#What-and-why)
@@ -97,6 +95,11 @@ To join the Discord server for more discussion, click <a href="https://discord.g
 <a href="https://www.linkedin.com/in/boddusripavan/"> Boddu Sri Pavan </a>
 
 ## Citation
+Our preprint is published in **TechRxiv**. Find it <a href="https://www.techrxiv.org/users/877016/articles/1256589-kitikiplot-a-python-library-to-visualize-categorical-sliding-window-data"> here <a/>
+
+Research paper is published in **GIS Science Journal** Volume 12 Issue 1, 186-193, 2025 (Scopus indexed with Impact factor **6.1**). </br>
+Read it here: <a href="https://zenodo.org/records/14632005">https://zenodo.org/records/14632005</a>
+
 APA <br>
 > Boddu Sri Pavan, Chandrasheker Thummanagoti, & Boddu Swathi Sree. (2025). KitikiPlot A Python library to visualize categorical sliding window data. https://doi.org/10.5281/zenodo.14632005.
 

kitikiplot-0.2.6.dist-info/RECORD

@@ -0,0 +1,12 @@
+kitikiplot/core/__init__.py,sha256=7LpJy1V-PZ-JlfjsnRMjMXxTKaFt0JP0mj-A0SgS-sE,34
+kitikiplot/core/kitiki_cell.py,sha256=ijxGWJcKDPWX_8iDRJ-RnunCfYilPKwZxwpTMegeyzY,7960
+kitikiplot/core/kitiki_color_config.py,sha256=yOWnJNoYo1BN7UMGTFgc8zpMljBbNpFDLLq7JZF3ATE,11857
+kitikiplot/core/kitikiplot.py,sha256=dkF49TeO9jCQnXEXpjL-la-AvnqvlChVsar3tkZ6yNQ,20822
+kitikiplot/ecology/linear.py,sha256=l1YVn7vcsKU-1g3SZ9kpOhHQiCRqP8U3LrWecy7_KFo,985
+kitikiplot/genomics/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+kitikiplot/genomics/grid.py,sha256=ohg5fBVezzxIOr2TlNPhND4PpBvzVG0eiSklTTbQp5s,1831
+kitikiplot/genomics/linear.py,sha256=BNO-9xPVq6dsP8KuXx1fJRG_mLUf2orCM3h7etYqhBw,1280
+kitikiplot-0.2.6.dist-info/LICENSE,sha256=14Bs-3ieyNjj9kCnVLv8CHRXEvQVM6P5uLe-pz7cBI0,1088
+kitikiplot-0.2.6.dist-info/METADATA,sha256=9X8hRZ71UYxTgQ0KJEsoSst7RriD_bgi-d9zPxBk8xE,5445
+kitikiplot-0.2.6.dist-info/WHEEL,sha256=fGIA9gx4Qxk2KDKeNJCbOEwSrmLtjWCwzBz351GyrPQ,88
+kitikiplot-0.2.6.dist-info/RECORD,,

kitikiplot-0.2.4.dist-info/RECORD

@@ -1,11 +0,0 @@
-kitikiplot/core/__init__.py,sha256=7LpJy1V-PZ-JlfjsnRMjMXxTKaFt0JP0mj-A0SgS-sE,34
-kitikiplot/core/kitiki_cell.py,sha256=9kn33x8-4Zp_fVdmp5NK-V7fm3hDXZOxwCNO3uDZqIo,7016
-kitikiplot/core/kitiki_color_config.py,sha256=34KEE1CQJeMnB6gA-FgTHiIEP7rF1_17xv2XOakh1ds,11969
-kitikiplot/core/kitikiplot.py,sha256=uH5eQnWxswQsDC1b77cu5U_2m3ODfKRGqCxcredRagQ,19746
-kitikiplot/genomics/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-kitikiplot/genomics/grid.py,sha256=ohg5fBVezzxIOr2TlNPhND4PpBvzVG0eiSklTTbQp5s,1831
-kitikiplot/genomics/linear.py,sha256=BNO-9xPVq6dsP8KuXx1fJRG_mLUf2orCM3h7etYqhBw,1280
-kitikiplot-0.2.4.dist-info/LICENSE,sha256=14Bs-3ieyNjj9kCnVLv8CHRXEvQVM6P5uLe-pz7cBI0,1088
-kitikiplot-0.2.4.dist-info/METADATA,sha256=bkB0ujGDsKDB6T_vail583iQejQmZx3o2PGS--L1X_c,5322
-kitikiplot-0.2.4.dist-info/WHEEL,sha256=fGIA9gx4Qxk2KDKeNJCbOEwSrmLtjWCwzBz351GyrPQ,88
-kitikiplot-0.2.4.dist-info/RECORD,,