PaIRS-UniNa 0.2.7__cp312-cp312-macosx_11_0_universal2.whl → 0.2.10__cp312-cp312-macosx_11_0_universal2.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;")
+
         #------------------------------------- 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)
@@ -296,6 +311,7 @@ class Calibration_Tab(gPaIRS_Tab):
 #*************************************************** Context Menu
     def contextMenuEvent(self, event):
         menu=QMenu(self)
+        menu.setStyleSheet(self.gui.ui.menu.styleSheet())
         name=[]
         act=[]
         fun=[]

PaIRS_UniNa/Changes.txt

@@ -1,3 +1,42 @@
+*********   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);