PaIRS-UniNa 0.2.0__cp310-cp310-win_amd64.whl → 0.2.8__cp310-cp310-win_amd64.whl

PaIRS_UniNa/Calibration_Tab.py

@@ -32,7 +32,8 @@ class CALpar(TABpar):
         self.Step           = Step
 
         self.FlagCalVi = False
-        self.ncam     = 1
+        self.ncam     = 2 if Process==ProcessTypes.spiv else 1
+        self.FlagCam  = False if Process==ProcessTypes.spiv else True
         self.calList  = []
         self.calEx    = []
         self.row      = -1
@@ -60,10 +61,6 @@ class Calibration_Tab(gPaIRS_Tab):
             self.app=app
             setAppGuiPalette(self)
 
-        #------------------------------------- Graphical interface: miscellanea
-        self.pixmap_warnc = QPixmap(u""+ icons_path +"warning_circle.png")
-        self.pixmap_done  = QPixmap(u""+ icons_path +"completed.png")
-
         #------------------------------------- Declaration of parameters 
         self.CALpar_base=CALpar()
         self.CALpar:CALpar=self.TABpar
@@ -82,7 +79,8 @@ class Calibration_Tab(gPaIRS_Tab):
         
         self.adjustTABpar=self.adjustCALpar
         self.setTABlayout=self.setCALlayout
-
+        self.checkTABpar=self.checkCALpar
+        self.setTABwarn=self.setCALwarn
 
         #------------------------------------- Initializing    
         if flagInit:     
@@ -99,15 +97,28 @@ class Calibration_Tab(gPaIRS_Tab):
     def adjustCALpar(self):
         if self.CALpar.Process==ProcessTypes.spiv:
            self.CALpar.ncam=2
+           self.CALpar.FlagCam=False
         self.ui.calTree.ncam=self.CALpar.ncam
 
-        self.CALpar.OptionDone = 1 if all(self.CALpar.calEx) and len(self.CALpar.calList)==self.CALpar.ncam else 0
+        self.checkCALpar()
         return
+    
+    def checkCALpar(self,ind=None,FlagRescan=False):
+        if ind is None: CAL:CALpar=self.CALpar
+        else: CAL:CALpar=self.TABpar_at(ind)
+        if FlagRescan: self.scanCalList(ind)
+        CAL.OptionDone = 1 if all(CAL.calEx) and len(CAL.calList)==CAL.ncam else 0
+
+    def scanCalList(self,ind=None):
+        if ind is None: CAL:CALpar=self.CALpar
+        else: CAL:CALpar=self.TABpar_at(ind)
+        for c in range(len(CAL.calList)):  #CAL.ncam
+            CAL.calEx[c]=os.path.exists(CAL.calList[c])
               
 #*************************************************** Layout
     def setCALlayout(self):
         self.ui.label_ncam.adjustSize()
-        self.ui.spin_ncam.setEnabled(self.CALpar.Process!=ProcessTypes.spiv)
+        self.ui.spin_ncam.setEnabled(self.CALpar.FlagCam)
 
         self.calibration_list_set()
 
@@ -125,22 +136,27 @@ class Calibration_Tab(gPaIRS_Tab):
 
         self.ui.button_CalVi.setVisible(self.CALpar.flagRun==0)
 
-        if self.CALpar.OptionDone==1:
-            self.CALpar.warningMessage='Calibration files correctly identified!'
+        self.checkCALpar()
+        self.setCALwarn()
+        self.setTABWarnLabel()
+        return
+
+    def setCALwarn(self,ind=None):
+        if ind is None: CAL:CALpar=self.CALpar
+        else: CAL:CALpar=self.TABpar_at(ind)
+        if CAL.OptionDone==1:
+            CAL.warningMessage='Calibration files correctly identified!'
         else:
             warningMessage=''
-            nFiles=len(self.CALpar.calList)
-            if nFiles<self.CALpar.ncam:
-                warningMessage+=f'Number of calibration files ({nFiles}) lower than number of cameras specified ({self.CALpar.ncam})!'
-            if not all(self.CALpar.calEx):
-                n=sum([1 if not ex else 0 for ex in self.CALpar.calEx])
-                if warningMessage: warningMessage+='\n'
-                warningMessage+=f'{n} out of {self.CALpar.ncam} calibration files missing!'
-            self.CALpar.warningMessage=warningMessage
-        self.ui.name_tab.setFixedWidth(self.ui.name_tab.sizeHint().width())
-        self.ui.label_done.setPixmap(self.pixmap_done if self.CALpar.OptionDone==1 else self.pixmap_warnc)
-        self.ui.label_done.setToolTip(self.CALpar.warningMessage)
-        return
+            nFiles=len(CAL.calList)
+            if nFiles<CAL.ncam:
+                warningMessage+=f'Number of calibration files ({nFiles}) lower than number of cameras specified ({CAL.ncam})!'
+            if not all(CAL.calEx):
+                n=sum([1 if not ex else 0 for ex in CAL.calEx])
+                if warningMessage: warningMessage='\n*  '
+                warningMessage+=f'{n} out of {CAL.ncam} calibration files missing!'
+            if '\n*  ' in warningMessage: warningMessage='*  '+warningMessage
+            CAL.warningMessage=warningMessage
 
 #*************************************************** Spin ncam
 #******************** Actions
@@ -158,7 +174,7 @@ class Calibration_Tab(gPaIRS_Tab):
 
     def button_import_action(self):
         filenames, _ = QFileDialog.getOpenFileNames(self,\
-            "Select image files from the current directory", filter='*.cal',\
+            "Select calibration files from the current directory", filter='*.cal',\
                 options=optionNativeDialog)
         if filenames:
             self.ui.calTree.hide()

PaIRS_UniNa/Changes.txt

@@ -1,23 +1,142 @@
-**********   Changes to version 0.1.13 (0.2.0 - 2024.07.03)  **********
-The latest version of PaIRS marks a departure from its predecessors. PaIRS now boasts a completely redesigned interface aimed at quick, simple, and efficient usability. Users bid farewell to Past, Present, and Future trees in favor of a new, more intuitive process management system (the Explorer): processes are organized into groups called projects and each project or process can be queued for later execution. Processes within each project can be modified until they are launched, and if necessary, reset and restarted from scratch. Each project also features a tree of deleted processes, allowing retrieval of outdated or abandoned processes.
+*********   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.
 
-Currently, PaIRS includes four types of processes: preprocessing, PIV (Particle Image Velocimetry), calibration, and stereoscopic PIV. Each of these processes consists of one or more steps, which can be optional or mandatory. Similar to the first version of PaIRS, these steps are editable via PaIRS iconic tabs (Input, Output, Process, etc.). The process tree provides immediate visibility into the status of each step, further streamlining management.
+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.
 
-The calibration process grants access to CalVi (Calibration Visualizer). It is no longer necessary to launch the PaIRS calibration tool separately; everything is conveniently available within a single interface.
+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.
 
-The Input tab introduces a completely renewed image import list, offering users total freedom without the constraints of the past.
 
-Additionally, the Vis tab introduces some exciting new features, such as the ability to modify colormaps and vector/streamline colors, along with improved handling of image/result loading.
+*********   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 to version 0.1.12 (0.1.13 - 2024.02.07)  **********
+
+*********   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);
+- resolved issues with velocity field visualization and stereo-PIV streamline representation;  
+- fixed undo/redo functionality, image tree selection issues, logging errors and focus-out signal handling.
+
+New features:
+- extended Vis features, including reference frame system plotting and vorticity field visualization;
+- introduced the ability to copy input and output information from other steps within the same process;
+- introduced functionality to interrupt processing before it starts if issues are detected.
+
+Performance improvements:
+- optimized thread usage and resource management for PIV and stereo-PIV;
+- streamlined process workflows, including faster and more reliable parameter updates.
+
+User-interface enhancements:
+- updated the CalVi Stop button to function as Save and improved its conditional display;
+- improved handling of project/process information and added better feedback for user actions.
+
+
+
+*********   Changes in version 0.2.3 (2024.11.06)  **********
+- Fixed bug in the functionality for replicating processes with changed input folders introduced in version v0.2.2.
+
+- Fixed bug in the compatibility check for the common region in disparity and stereoscopic PIV analysis steps.
+
+
+
+*********   Changes in version 0.2.2 (2024.10.15)  **********
+- [!!! Critical !!!] Fixed critical errors in the calculation of Reynolds stresses for stereoscopic PIV processes. Please consider reviewing the results from processes executed with version 0.2.1, as the w'w', u'w', and v'w' stresses were incorrectly calculated.
+
+- Introduced the "Laser Equation Plane" box in the Output tab to specify the initial attempt in the disparity step or to independently assign the constant values of the laser plane during the stereoscopic PIV step.
+
+- Introduced the "Copy process to loop over folders" button in the process tree. The latter allows the user to select multiple folders from the disk and replicate the process in the tree for each folder, automatically updating the input image path (specified in the Input tab) to match the path of each selected folder. This makes it extremely easy and fast to create a queue of processes for folders containing similar image sets.
+
+- Resolved various bugs related to the copy and link functions of steps within the process tree. Buttons have been relocated to the Explorer, and additional functionality has been added to the context menu of the process tree items.
+
+- Improved stability and interface performance.
+
+- The guide of PaIRS-UniNa v0.2 is now available. Discover all the information you need for advanced software usage at https://www.pairs.unina.it/web/PaIRS-UniNa-v020-Guide.pdf.
+
+
+
+*********   Changes in version 0.2.1 (2024.07.08)  **********
+- Fixed bugs for Python 3.11 and 3.12.
+
+- Fixed bugs related to use of historical minimum background image in disparity and image analysis steps.
+
+- Fixed minor bugs.
+
+
+
+**********   Changes in 0.2.0 (2024.07.03)  **********
+- The latest version of PaIRS marks a departure from its predecessors. PaIRS now boasts a completely redesigned interface aimed at quick, simple, and efficient usability. Users bid farewell to Past, Present, and Future trees in favor of a new, more intuitive process management system (the Explorer): processes are organized into groups called projects and each project or process can be queued for later execution. Processes within each project can be modified until they are launched, and if necessary, reset and restarted from scratch. Each project also features a tree of deleted processes, allowing retrieval of outdated or abandoned processes.
+
+- Currently, PaIRS includes four types of processes: preprocessing, PIV (Particle Image Velocimetry), calibration, and stereoscopic PIV. Each of these processes consists of one or more steps, which can be optional or mandatory. Similar to the first version of PaIRS, these steps are editable via PaIRS iconic tabs (Input, Output, Process, etc.). The process tree provides immediate visibility into the status of each step, further streamlining management.
+
+- The calibration process grants access to CalVi (Calibration Visualizer). It is no longer necessary to launch the PaIRS calibration tool separately; everything is conveniently available within a single interface.
+
+- The Input tab introduces a completely renewed image import list, offering users total freedom without the constraints of the past.
+
+- Additionally, the Vis tab introduces some exciting new features, such as the ability to modify colormaps and vector/streamline colors, along with improved handling of image/result loading.
+
+
+
+**********   Changes in version 0.1.13 (2024.02.07)  **********
 - Fixed bugs related to navigation across the Past, Present and Future trees in the Queue tab.
+
 - Minor changes in Vis.
 
 
 
-**********   Changes to version 0.1.11 (0.1.12 - 2024.02.02)  **********
+**********   Changes in version 0.1.12 (2024.02.02)  **********
 - PaIRS now includes the possibility to customize the windowing parameters for each iteration of a PIV process. The user can choose the windowing parameters for each iteration in the initial phase of the PIV process. This is possible by operating in the Windowing box at the bottom of the Process tab (visible only in the expert mode). A table widget has been added to this section, where the user can find all relevant information the windowing scheme for the PIV process and modify it iteration by iteration. By selecting the corresponding row of the table, the user can choose for the current iteration the type of weighting window to be used in the calculation of the absolute velocity and in the determination of the correlation map, if using the direct correlations or not and the maximum displacement allowed in the interrogation window. The latter parameter is an innovation of the present version itself and adds to the custom settings selectable by the user to build affordable validation strategies. In addition, in the table an indication about the stability of the windowing scheme for each iteration is reported. In conclusion, a larger degree of customization of the PIV process comes with the present modification of PaIRS.
  
 - CalVi now fully supports optical camera calibration for transparent cylindrical geometries. In the version 0.1.10 this camera model was available only in debug mode for beta testers and developers, now it is fully working. The calibration of this camera model is however a delicate task and the user is referred to the CalVi guide for reliable experimental procedures that could be used in this direction.

PaIRS_UniNa/Custom_Top.py

@@ -212,16 +212,19 @@ class Custom_Top(QDialog):
             item.setData(0,Qt.UserRole,item.text(0))
 
     def saveCustomList(self):
-        with open(self.custom_list_file,'w') as file:
-            for c in self.custom_list:
-                file.write(c+'\n')
-            file.close()
+        try:
+            with open(self.custom_list_file,'w') as file:
+                for c in self.custom_list:
+                    file.write(c+'\n')
+                file.close()
+        except:
+            pri.Error.red(f'Error while trying to save the custom process list: {self.custom_list_file}.\n{traceback.format_exc()}\n')
 
 
     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,\
@@ -235,7 +238,7 @@ class Custom_Top(QDialog):
                     data=pickle.load(file)
                     PROpar=data.PRO
             except Exception as inst:
-                pri.Error.red(f'Error while loading past process:\n{traceback.print_exc()}\n\n{inst}\n')
+                pri.Error.red(f'Error while loading past process:\n{traceback.format_exc()}\n\n{inst}\n')
                 WarningMessage=f'Error while importing {filename}. Perhaps, the file is corrupted.'
                 warningDialog(self,WarningMessage)
                 return
@@ -244,7 +247,7 @@ class Custom_Top(QDialog):
                 p=PaIRS_lib.PIV()
                 p.readCfgProc(filename)
             except Exception as inst:
-                pri.Error.red(f'Error while loading the cfg file {filename}:\n{traceback.print_exc()}\n\n{inst}\n')
+                pri.Error.red(f'Error while loading the cfg file {filename}:\n{traceback.format_exc()}\n\n{inst}\n')
                 errPIVlib='\n'.join(str(inst.args[0]).split('\n')[3:]) #str(inst.__cause__).split('\n')[3] #solved
                 WarningMessage=f'Error while importing {filename}:\n{errPIVlib}'
                 warningDialog(self,WarningMessage)
@@ -257,7 +260,7 @@ class Custom_Top(QDialog):
                     if type(a)==float:
                         setattr(PROpar,f,round(a,4))
             except Exception as inst:
-                pri.Error.red(f'Error while loading the cfg file {filename}:\n{traceback.print_exc()}\n\n{inst}\n')
+                pri.Error.red(f'Error while loading the cfg file {filename}:\n{traceback.format_exc()}\n\n{inst}\n')
                 WarningMessage=f'Error while importing {filename}. Perhaps, the .cfg file does not correspond to a valid PIV process or the file is corrupted.'
                 warningDialog(self,WarningMessage)
                 return
@@ -285,7 +288,7 @@ class Custom_Top(QDialog):
                 self.createItemInTree(self.ui.tree,self.queue,name,name,QIcon())
                 self.custom_list.append(name)
         except Exception as inst:
-            pri.Error.red(f'Error while saving custom process file {filename}:\n{traceback.print_exc}\n\n{inst}')
+            pri.Error.red(f'Error while saving custom process file {filename}:\n{traceback.format_exc()}\n\n{inst}')