PaIRS-UniNa 0.2.4__cp311-cp311-win_amd64.whl → 0.2.11__cp311-cp311-win_amd64.whl

PaIRS_UniNa/Calibration_Tab.py

@@ -1,6 +1,7 @@
 from .ui_Calibration_Tab import*
 from .TabTools import*
 from .listLib import*
+from .SPIVCalHelp import showSPIVCalHelp
 
 spin_tips={
     'ncam'  : 'Number of cameras',
@@ -21,6 +22,7 @@ button_tips={
 combo_tips={}
 
 class CALpar(TABpar):
+    FlagSPIVCal = True
     def __init__(self,Process=ProcessTypes.null,Step=StepTypes.null):
         self.setup(Process,Step)
         super().__init__('CALpar','Calibration')
@@ -61,6 +63,8 @@ class Calibration_Tab(gPaIRS_Tab):
             self.app=app
             setAppGuiPalette(self)
 
+        self.ui.button_info.setStyleSheet("border: none;")
+        self.ui.calTree.contextMenuEvent=lambda ev: calTreeContextMenuEvent(self.ui.calTree,self,ev)
         #------------------------------------- Declaration of parameters 
         self.CALpar_base=CALpar()
         self.CALpar:CALpar=self.TABpar
@@ -133,6 +137,7 @@ class Calibration_Tab(gPaIRS_Tab):
         self.ui.button_paste_below.setEnabled(FlagNCal and FlagCuttedItems)
         self.ui.button_paste_above.setEnabled(FlagNCal and FlagCuttedItems)
         self.ui.button_clean.setEnabled(FlagFiles)
+        self.ui.button_info.setVisible(self.CALpar.Process==ProcessTypes.spiv)
 
         self.ui.button_CalVi.setVisible(self.CALpar.flagRun==0)
 
@@ -166,13 +171,23 @@ class Calibration_Tab(gPaIRS_Tab):
 #*************************************************** Buttons
 #******************** Actions
     def button_CalVi_action(self):
+        if CALpar.FlagSPIVCal and self.ui.button_info.isVisible() and self.ui.button_CalVi.isChecked():
+            showSPIVCalHelp(self,self.dontShowAgainSPIVCalHelp)
         self.CALpar.FlagCalVi=self.ui.button_CalVi.isChecked()
 
+    def dontShowAgainSPIVCalHelp(self):
+        CALpar.FlagSPIVCal = False
+
+    def button_info_action(self):
+        showSPIVCalHelp(self)
+
     def button_scan_list_action(self):
         self.ui.calTree.setLists()
         self.CALpar.calEx=deep_duplicate(self.ui.calTree.calEx)
 
     def button_import_action(self):
+        if CALpar.FlagSPIVCal and self.ui.button_info.isVisible():
+            showSPIVCalHelp(self,self.dontShowAgainSPIVCalHelp)
         filenames, _ = QFileDialog.getOpenFileNames(self,\
             "Select calibration files from the current directory", filter='*.cal',\
                 options=optionNativeDialog)
@@ -294,30 +309,31 @@ class Calibration_Tab(gPaIRS_Tab):
             self.ui.calTree.topLevelItem(self.CALpar.row).setSelected(True)
 
 #*************************************************** Context Menu
-    def contextMenuEvent(self, event):
-        menu=QMenu(self)
-        name=[]
-        act=[]
-        fun=[]
-        for nb in self.calibrationTreeButtons:
-            if '-' not in nb and '|' not in nb:
-                b:QPushButton=getattr(self.ui,'button_'+nb)
-                if b.isVisible() and b.isEnabled():
-                    if hasattr(self,'button_'+nb+'_callback'):
-                        name.append(nb)
-                        act.append(QAction(b.icon(),toPlainText(b.toolTip().split('.')[0]),self))
-                        menu.addAction(act[-1])
-                        callback=getattr(self,'button_'+nb+'_callback')
-                        fun.append(callback)
-            elif '|' in nb:
-                if len(act): menu.addSeparator()
-
-        if len(act):
-            action = menu.exec(self.mapToGlobal(event.pos()))
-            for nb,a,f in zip(name,act,fun):
-                if a==action: 
-                    TABpar.FlagSettingPar=False
-                    f()
+def calTreeContextMenuEvent(obj, self, event):
+    menu=QMenu(obj)
+    menu.setStyleSheet(gPaIRS_QMenu_style)
+    name=[]
+    act=[]
+    fun=[]
+    for nb in self.calibrationTreeButtons:
+        if '-' not in nb and '|' not in nb:
+            b:QPushButton=getattr(self.ui,'button_'+nb)
+            if b.isVisible() and b.isEnabled():
+                if hasattr(self,'button_'+nb+'_callback'):
+                    name.append(nb)
+                    act.append(QAction(b.icon(),toPlainText(b.toolTip().split('.')[0]),self))
+                    menu.addAction(act[-1])
+                    callback=getattr(self,'button_'+nb+'_callback')
+                    fun.append(callback)
+        elif '|' in nb:
+            if len(act): menu.addSeparator()
+
+    if len(act):
+        action = menu.exec(obj.mapToGlobal(event.pos()))
+        for nb,a,f in zip(name,act,fun):
+            if a==action: 
+                TABpar.FlagSettingPar=False
+                f()
 
 if __name__ == "__main__":
     import sys

PaIRS_UniNa/Changes.txt

@@ -1,3 +1,101 @@
+*********   Changes in version 0.2.11 (2026.02.02)  **********
+Bug fixes:
+- fixed an issue preventing correct restoration of reshape/resize settings in the Output tab at startup of the interface.
+
+User-interface enhancements:
+- minor UI restyling aimed at improving visual feedback, with clearer highlighting of widgets involved in user interactions;
+- introduced the functionality to detach the Vis plot area from the main window, enabling users to visualize images and results more comfortably and effectively in a separate floating window;
+- added a dedicated Window menu, allowing users to quickly apply convenient interface layouts and better manage detached windows.
+
+
+
+*********   Changes in version 0.2.10 (2026.01.05)  **********
+Bug fixes:
+- fixed a bug affecting the "Edit list" functionality of the image-tree in the Input tab; the feature is now fully operational and behaves as expected;
+- fixed a minor issue that could affect the correct assessment of the PIV process stability.
+
+User-interface enhancements:
+- minor UI restyling aimed at improving visual feedback, with clearer highlighting of widgets involved in user interactions;
+- improved the visualization of contextual help messages, providing clearer and more consistent tooltip-like feedback within the interface;
+- enhanced the management and restoration of global tab settings to ensure better consistency when loading previously saved workspaces.
+
+
+
+*********   Changes in version 0.2.9 (2025.12.12)  **********
+Bug fixes:
+- fixed a bug in the batch folder-copy tool enabling automatic removal of incomplete image pairs and a full re-scan of destination folders to detect and resolve any image-set mismatches.
+
+New features:
+- a new help dialog has been introduced to assist users during the stereoscopic PIV calibration process. The dialog provides a detailed explanation of the required coordinate convention (plate defining the x–y plane, z-axis normal to the plate and x-axis aligned with the stereoscopic baseline) and displays example images illustrating correct and incorrect configurations.
+
+
+
+*********   Changes in version 0.2.8 (2025.11.14)  **********
+Bug fixes:
+- corrected a bug in the z-vorticity computation: velocity gradients were not properly converted to physical units, causing an error in the magnitude scales though not in the qualitative distributions;
+- corrected the display of maps of output variables and vector fields in Vis to ensure proper alignment across option changes;
+- fixed issues related to path handling in the batch-folder copy and other modules: paths are no longer relativized, avoiding inconsistent behavior across different operating systems or different.
+
+New features:
+- added new options in the batch folder-copy tool to automatically remove image pairs where one or more files are missing in the destination folders and to fully re-scan the destination folders for cases in which mismatches in the image sets may occur;
+- extended the existing functionality in Vis for loading and visualizing past results located under the specified output path and name root: when available, the corresponding saved log file is now automatically loaded and displayed in the Log tab.
+
+User-interface enhancements:
+- improved the naming logic for duplicated processes: copied processes are now assigned consistent incremental suffixes;
+- improved the example-image tree and the behavior of the step spin box in the Image Import Tool (minimum step is now 1); 
+- refined the behavior of the import button: it is now always enabled, and when no changes in the image list are detected upon importing, the user simply receives a warning message;
+- improved the behaviour of the list of path completers in the Input tabs; 
+- in Vis, resizing settings and automatic level-reset options are no longer global but apply individually per each step.
+
+
+*********   Changes in version 0.2.7 (2025.10.13)  **********
+Bug fixes:
+- resolved an issue related to visulazion of streamlines when the image is shown in pixel units and a custom resolution is specified (in previous versions, streamlines were always represented in physical units);
+- corrected the update of reprojection errors in CalVi when the control point grid is expanded after a calibration. Each new control point now has its error recalculated and plotted, providing a correct view of the extrapolation error;
+- fixed the automatic resize/reshape behavior specified in the Output tab: when an image transformation is assigned, it is now preserved even if the automatic reshape button is active.
+
+User-interface enhancements:
+- changed the behavior of the Vis button for restricting view on the interrogation window area: clicking it now opens a popup menu that allows users to select the desired interrogation-window size to focus on among all iterations of the process;
+- names of processes duplicated in the process tree are now automatically updated to avoid conflicts: if a name already exists, the new one is appended with an incremental suffix;
+- improved interaction with editable input fields: when hovering the highlighted style is displayed correctly, the text cursor now appears exactly where clicked and the background color is properly restored when leaving the field.
+
+
+
+*********   Changes in version 0.2.6 (2025.09.06)  **********
+Bug fixes:
+- fixed bugs related to process tree management.
+
+User-interface enhancements:
+- enhanced release check using SSL for reliable retrieval of the latest version.
+
+Distribution:
+- ready-to-use executables of PaIRS are now available!
+
+
+
+*********   Changes in version 0.2.5 (2025.07.28)  **********
+Bug fixes:
+- fixed bugs in launching PIV and stereoscopic PIV processes in special cases;
+- fixed tooltip crash introduced by PySide 6.9;
+- corrected package import errors and context menu bugs;
+- resolved multiple visual glitches in image tree selection and map visualization.
+
+New features:
+- implemented version control of required Python packages with automatic compatibility check and warning;
+- disparity maps are now automatically saved in the output folder and can be visualized in Vis;
+- added support for restricting view in Vis based on interrogation window size and shifting the view window interactively.
+
+User-interface enhancements:
+- redesigned the execution logic of internal workers for improved control and robustness;
+- improved formatting and display of coordinates and variable values when moving the cursor during map visualization;
+- updated button labels and layout for clarity and consistency.
+
+Distribution:
+- Support for Python 3.9 has been discontinued;
+- Python 3.13 builds have been successfully created and tested in Windows. 
+
+
+
 *********   Changes in version 0.2.4 (2024.12.01)  **********
 Bug fixes:
 - fixed critical bugs in process handling and calibration step (CalVi usage, closing PaIRS during CalVi operation, resetting steps while running);

PaIRS_UniNa/Custom_Top.py

@@ -224,7 +224,7 @@ class Custom_Top(QDialog):
     def loadPastProc(self,*args):
         if len(args): inpath=args[0]
         else: inpath='./'
-        ext_pro=f'*{outExt.min}; *{outExt.piv}; *.cfg' 
+        ext_pro=f'*{outExt.min} *{outExt.piv}  *.cfg' 
         filename, _ = QFileDialog.getOpenFileName(self,\
                 "Select an image file of the sequence", filter=ext_pro,\
                     dir=inpath,\