PaIRS-UniNa 0.2.8__cp312-cp312-win_amd64.whl → 0.2.9__cp312-cp312-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;")
+
         #------------------------------------- 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 self.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):
+        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 self.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)

PaIRS_UniNa/Changes.txt

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