PaIRS-UniNa 0.2.5__cp313-cp313-win_amd64.whl → 0.2.9__cp313-cp313-win_amd64.whl

PaIRS_UniNa/PaIRS_pypacks.py

@@ -15,10 +15,12 @@ basefold_DEBUG='./'
 basefold_DEBUG_VIS=''
 #basefold='B:/dl/apairs/jetcross'
 
+
 developerIDs={
     'GP_Win_Office': '231128824800632', #'0x7824af430781',
     'GP_Win_Office_New': '140626882900161', #'0x7824af430781',
     'GP_Mac_Laptop': 'V94LRP93FV', #'0xa275dd445ab0',
+    'GP_WSL'       : 'b44ec1c0e5a74ffd97bb050c39ef6cb1',
     'TA_Win_Office': '160983906000941',           #'0xccb0da8c896e'
     'TA_Win_Office_New': '231128824801036',           #??
      }
@@ -29,9 +31,32 @@ def getCurrentID():
     serial_number=None
     try:
         if psutil.LINUX:
+            def get_linux_serial():
+                from pathlib import Path
+                candidates = [
+                    Path("/sys/class/dmi/id/board_serial"),
+                    Path("/sys/class/dmi/id/product_uuid"),
+                    Path("/etc/machine-id"), Path("/var/lib/dbus/machine-id") #WSL
+                ]
+                for p in candidates:
+                    try:
+                        if p.is_file():
+                            val = p.read_text(errors="ignore").strip()
+                            if val and val.lower() not in {
+                                "none", "unknown", "not specified", "to be filled by o.e.m."
+                            }:
+                                return val
+                    except Exception as e:
+                        if Flag_DEBUG:
+                            print(f"Error while retrieving motherboard serial number: {e}")
+                        continue
+                return None
+            serial_number = get_linux_serial()
+            """"
             # On Linux, the motherboard serial number can be obtained from the /sys/class/dmi/id/board_serial file
             with open('/sys/class/dmi/id/board_serial', 'r') as f:
                 serial_number = f.read().strip()
+            """
         elif psutil.WINDOWS:
             # On Windows, the motherboard serial number can be obtained using WMI
             output = subprocess.check_output(["wmic", "baseboard", "get", "SerialNumber"]).decode('utf-8')
@@ -43,7 +68,8 @@ def getCurrentID():
                 if b'Serial Number (system)' in line:
                     serial_number = line.split(b':')[1].strip().decode('utf-8')
     except Exception as e:
-        print(f"Error while retrieving motherboard serial number: {e}")
+        if Flag_DEBUG:
+            print(f"Error while retrieving motherboard serial number: {e}")
     return serial_number
 
 currentID=getCurrentID()
@@ -58,6 +84,16 @@ if currentID in (developerIDs['GP_Win_Office'],developerIDs['GP_Win_Office_New']
                             'C:/desk/PIV_Img/_data/Calibration_data/cylinder/',
                             ]
     basefold_DEBUG_VIS='C:/desk/PIV_Img/_data/PIV_data/real_case/'
+elif  currentID==developerIDs['GP_WSL']:
+    basefold_DEBUG='/mnt/c/desk/PIV_Img/_data/PIV_data/virtual_case/'
+    basefold_DEBUGOptions=[
+                            '/mnt/c/desk/PIV_Img/img1/',
+                            '/mnt/c/desk/PIV_Img/_data/PIV_data/virtual_case/', 
+                            '/mnt/c/desk/PIV_Img/_data/PIV_data/real_case/',
+                            '/mnt/c/desk/PIV_Img/_data/Calibration_data/pinhole/',
+                            '/mnt/c/desk/PIV_Img/_data/Calibration_data/cylinder/',
+                            ]
+    basefold_DEBUG_VIS='/mnt/c/desk/PIV_Img/_data/PIV_data/real_case/'
 elif currentID==developerIDs['GP_Mac_Laptop']: #gerardo mac
     basefold_DEBUG='/Users/gerardo/Desktop/PIV_Img/swirler_png/' #'/Users/gerardo/Desktop/PIV_Img/img1/'
     basefold_DEBUGOptions=[
@@ -72,12 +108,12 @@ elif currentID==developerIDs['GP_Mac_Laptop']: #gerardo mac
     basefold_DEBUG_VIS='/Users/gerardo/Desktop/PaIRS_examples/PIV_data/real_case/'
     basefold_DEBUG_VIS='/Users/gerardo/Desktop/PIV_Img/img1/'
 elif currentID in (developerIDs['TA_Win_Office'],developerIDs['TA_Win_Office_New']): #TA windows
-    basefold_DEBUG='C:\desk\Attuali\PythonLibC\PIV\img'
+    basefold_DEBUG=r'C:\desk\Attuali\PythonLibC\PIV\img'
     basefold_DEBUGOptions=[
                             'C:/desk/PIV_Img/img1/',
                             'C:/desk/PIV_Img/swirler_png/',                            
                             '../../img/calib/',
-                            'C:\desk\Attuali\PythonLibC\PIV\img',
+                            r'C:\desk\Attuali\PythonLibC\PIV\img',
                             ]
     basefold_DEBUG_VIS=''
 else:
@@ -106,6 +142,7 @@ f_empty_width=250  #blank space in scrollable area within the main window
 time_ScrollBar=250 #time of animation of scroll area
 time_callback2_async=0  #time to test async callbacks
 time_showSplashOnTop=250
+pathCompleterLength=10
 
 fileChanges='Changes.txt'
 fileWhatsNew=['whatsnew.txt','whatwasnew.txt']
@@ -149,6 +186,37 @@ import sys
 import concurrent.futures
 import asyncio
 
+_old_init_QAction = QAction.__init__
+def _new_init_QAction(self, *args, **kwargs):
+    _old_init_QAction(self, *args, **kwargs)
+    try:
+        self.setIconVisibleInMenu(True)
+    except Exception:
+        pass
+QAction.__init__ = _new_init_QAction
+_old_init_QMenu = QMenu.__init__
+def _new_init_QMenu(self, *args, **kwargs):
+    _old_init_QMenu(self, *args, **kwargs)
+    try:
+        self.menuAction().setIconVisibleInMenu(True)
+    except Exception:
+        pass
+QMenu.__init__ = _new_init_QMenu
+
+# --- Patch dei metodi QMenu che CREANO/AGGIUNGONO azioni (copre gli overload C++) ---
+_old_addAction = QMenu.addAction
+def _new_addAction(self, *args, **kwargs):
+    act:QAction = _old_addAction(self, *args, **kwargs)   # può essere creato lato C++
+    try:
+        if isinstance(act, QAction):
+            act.setIconVisibleInMenu(True)
+    except Exception:
+        pass
+    return act
+QMenu.addAction = _new_addAction
+
+Flag_ISEXE=getattr(sys, 'frozen', False) #made by pyInstaller
+EXEurl='https://www.pairs.unina.it/#download'
 
 class ColorPrint:
     def __init__(self,flagTime=False,prio=PrintTAPriority.medium,faceStd=PrintTA.faceStd,flagFullDebug=False):
@@ -184,6 +252,7 @@ class GPaIRSPrint:
         self.Info=ColorPrint(prio=PrintTAPriority.medium)
         self.Time=ColorPrint(prio=PrintTAPriority.medium if FlagPrintTime else PrintTAPriority.veryLow,flagTime=True,faceStd=PrintTA.faceUnderline)        
         self.Error=ColorPrint(prio=PrintTAPriority.medium,faceStd=PrintTA.faceBold)
+        self.IOError=ColorPrint(prio=PrintTAPriority.veryLow,faceStd=PrintTA.faceBold)
         self.Process=ColorPrint(prio=PrintTAPriority.veryLow)
         self.Callback=ColorPrint(prio=PrintTAPriority.veryLow)
         self.TABparDiff=ColorPrint(prio=PrintTAPriority.veryLow)
@@ -237,7 +306,6 @@ if __package__ or "." in __name__:
     foldPaIRS = foldPaIRS.replace('\\', '/')
 else:
     foldPaIRS='./'
-
 class ProcessTypes:
     null=None
     min=0
@@ -247,7 +315,7 @@ class ProcessTypes:
     cal=10
 
     singleCamera=[piv]
-    threeCameras=[tpiv]
+    threeCameras=[min,tpiv]
 
 class StepTypes:
     null=None
@@ -291,15 +359,24 @@ class outExt:
     cfg_calvi='.calvi_cfg'
     pla='.pairs_pla'
 
-    
 
 lastcfgname='lastWorkSpace'+outExt.wksp
-
 fileChanges=foldPaIRS+'Changes.txt'
-fileWhatsNew=[foldPaIRS+f for f in fileWhatsNew]
 icons_path=foldPaIRS+icons_path
-lastcfgname=foldPaIRS+lastcfgname
-pro_path=foldPaIRS+"pro/"
+
+if not Flag_ISEXE:
+    fileWhatsNew=[foldPaIRS+f for f in fileWhatsNew]
+    
+    lastcfgname=foldPaIRS+lastcfgname
+    pro_path=foldPaIRS+"pro/"
+else:
+    from pathlib import Path
+    exe_dir = str(Path(sys.argv[0]).resolve().parent)+'/'
+    fileWhatsNew=[foldPaIRS+fileWhatsNew[0],exe_dir+fileWhatsNew[1]]
+    lastcfgname = exe_dir + lastcfgname
+    pro_path = exe_dir + "pro/"
+     
+
 if not os.path.exists(pro_path):
     try:
         os.mkdir(pro_path)
@@ -558,6 +635,13 @@ def myStandardRoot(root):
     currroot = re.sub('/+', '/', currroot)  # Reduce consecutive slashes to a single slash
     return currroot
 
+def relativizePath(currpath:str):
+    return currpath
+    directory_path = myStandardPath(os.getcwd())
+    if directory_path in currpath:
+        currpath=currpath.replace(directory_path,'./') 
+    return currpath
+    
 def findFiles_sorted(pattern):
     list_files=glob.glob(pattern)
     files=sorted([re.sub(r'\\+',r'/',f) for f in list_files],key=str.lower)
@@ -682,6 +766,43 @@ def identifierName(typeObject:str='proc'):
     name=version_user_info+'_'+typeObject+'_'+id
     return name, username, __version__
 
+def fileIdenitifierCheck(id: str, filename: str) -> bool:
+    """
+    Extract the date/time from the identifier 'name' and check whether 'filename'
+    has been modified after that timestamp.
+    Returns True if file is newer, False otherwise.
+    """
+
+    # --- Extract timestamp from name ---
+    # Expected pattern:  ..._<date>-<time>_...
+    # Example: 'PaIRS-v0.2.8_Linux-user_2025/11/07-12:45:31_proc_...'
+    try:
+        parts = id.split('_')
+        date_str, time_str = parts[2].split('-')[0], parts[2].split('-')[1]
+    except Exception:
+        pri.Error.red("Identifier format not recognized: cannot extract date and time.")
+        return False
+
+    # Convert date/time strings into QDateTime
+    qdate = QDate.fromString(date_str, 'yyyy/MM/dd')
+    qtime = QTime.fromString(time_str, 'HH:mm:ss')
+    qdt_identifier = QDateTime(qdate, qtime)
+    qdt_identifier = qdt_identifier.addSecs(-1) #to be safe
+
+    if not qdt_identifier.isValid():
+        pri.Error.red("Parsed QDateTime is not valid. Check identifier format.")
+        return False
+
+    # --- File timestamp ---
+    if not os.path.exists(filename):
+        return False
+
+    file_mtime = os.path.getmtime(filename)
+    qdt_file = QDateTime.fromSecsSinceEpoch(int(file_mtime))
+
+    # True if file was modified after the timestamp stored in name
+    return qdt_file > qdt_identifier
+
 PlainTextConverter=QtGui.QTextDocument()
 def toPlainText(text):
     PlainTextConverter.setHtml(text) #for safety
@@ -782,12 +903,16 @@ def runPaIRS(self,command='',flagQuestion=True):
         def run(self):
             try:
                 import subprocess
-                if Flag: #launched from package
-                    pri.Info.white(sys.executable+' -m PaIRS_UniNa '+command)
-                    subprocess.call(sys.executable+' -m PaIRS_UniNa '+command,shell=True)
+                if Flag_ISEXE:
+                    pri.Info.white(sys.executable+' '+command)
+                    subprocess.call(sys.executable+' '+command,shell=True)
                 else:
-                    pri.Info.white(sys.executable+' -c '+'"'+f"import os; os.chdir('{os.getcwd()}'); {pyCommands[command]}"+'"')
-                    subprocess.call(sys.executable+' -c '+'"'+f"import os; os.chdir('{os.getcwd()}'); {pyCommands[command]}"+'"',shell=True)
+                    if Flag: #launched from package
+                        pri.Info.white(sys.executable+' -m PaIRS_UniNa '+command)
+                        subprocess.call(sys.executable+' -m PaIRS_UniNa '+command,shell=True)
+                    else:
+                        pri.Info.white(sys.executable+' -c '+'"'+f"import os; os.chdir('{os.getcwd()}'); {pyCommands[command]}"+'"')
+                        subprocess.call(sys.executable+' -c '+'"'+f"import os; os.chdir('{os.getcwd()}'); {pyCommands[command]}"+'"',shell=True)
                 self.isRunning=False
             except Exception as inst:
                 pri.Error.red(inst)
@@ -816,12 +941,12 @@ def showSplash(filename=''+ icons_path +'logo_PaIRS_completo.png'):
     splash.show()
     return splash
 
-def checkLatestVersion(self,version,app:QApplication=None,splash:QLabel=None):
+def checkLatestVersion(self,version,app:QApplication=None,splash:QLabel=None,flagWarning=1):
     flagStopAndDownload=False
     var=self.TABpar
     #var.FlagOutDated=0 if currentVersion==var.latestVersion else var.FlagOutDated
     if abs(var.FlagOutDated)==1:
-        warningLatestVersion(self,app,flagExit=0,flagWarning=1,FlagStayOnTop=True)
+        warningLatestVersion(self,app,flagExit=0,flagWarning=flagWarning,FlagStayOnTop=True)
         var.FlagOutDated=2 if var.FlagOutDated==1 else -2
         """
         flagStopAndDownload=questionDialog(self,f'A new version of the PaIRS_UniNa package is available. Do you want to download it before starting the current istance of {self.name}?')
@@ -852,7 +977,7 @@ def checkLatestVersion(self,version,app:QApplication=None,splash:QLabel=None):
             var.FlagOutDated=-2 if var.FlagOutDated==-2 else -1
         elif flagOutDated==-1000:
             sOut=f'Error from pip: it was not possible to check for a new version of the {packageName} package!'
-            var.FlagOutDated=0
+            var.FlagOutDated=-1000
         else:
             sOut=f'{packageName} The current version ({currentVersion}) of {packageName} is up-to-date! Enjoy it!'
             var.FlagOutDated=0
@@ -872,13 +997,18 @@ def warningLatestVersion(self,app,flagExit=0,flagWarning=0,time_milliseconds=0,F
     py=myStandardRoot(sys.executable).split('/')[-1].split('.')[0]
     command=f'{py} -m pip install --upgrade PaIRS_UniNa'
     if self.TABpar.FlagOutDated>0:
-        Message=f'A new version of the PaIRS_UniNa package is available (current: {self.TABpar.currentVersion}, latest: {self.TABpar.latestVersion}).\nPlease, {exitSuggestion}install it with the following command:\n{command}'
+        if Flag_ISEXE:
+            Message=f'A new version of the PaIRS_UniNa package is available (current: {self.TABpar.currentVersion}, latest: {self.TABpar.latestVersion}).\nPlease, download it from the following link:\n{EXEurl}'
+        else:
+            Message=f'A new version of the PaIRS_UniNa package is available (current: {self.TABpar.currentVersion}, latest: {self.TABpar.latestVersion}).\nPlease, {exitSuggestion}install it with the following command:\n{command}'
+    elif self.TABpar.FlagOutDated==-1000:
+        Message = ("Unable to check for the latest official release of PaIRS_UniNa. Please check the PyPI page manually for updates:\n""https://pypi.org/project/PaIRS-UniNa/")
     else:
         Message=f'The version of the current instance of PaIRS_UniNa ({self.TABpar.currentVersion}) is newer than the latest official releas ({self.TABpar.latestVersion})!\nYou should contact Tommaso and Gerardo if you are a developer and some relevant change is made by yourself!\nIf you are a user, enjoy this beta version and please report any issue!'
     if flagExit:
         print(f"\n{'*'*100}\n"+Message+f"\n{'*'*100}\n")
     if flagWarning:
-        warningDialog(self,Message,time_milliseconds=time_milliseconds,flagScreenCenter=True,pixmap=''+ icons_path +'flaticon_PaIRS_download.png' if self.TABpar.FlagOutDated>0 else ''+ icons_path +'flaticon_PaIRS_beta.png',FlagStayOnTop=FlagStayOnTop,addButton={"See what's new!": lambda: QDesktopServices.openUrl(QUrl("https://pypi.org/project/PaIRS-UniNa/"))} if self.TABpar.FlagOutDated>0 else {})    
+        warningDialog(self,Message,time_milliseconds=time_milliseconds,flagScreenCenter=True,pixmap=''+ icons_path +'flaticon_PaIRS_download.png' if self.TABpar.FlagOutDated>0 else ''+ icons_path +'flaticon_PaIRS_download_warning.png' if self.TABpar.FlagOutDated==-1000 else ''+ icons_path +'flaticon_PaIRS_beta.png',FlagStayOnTop=FlagStayOnTop,addButton={"Go to the download page!": lambda: QDesktopServices.openUrl(QUrl(EXEurl))} if Flag_ISEXE else {"See what's new!": lambda: QDesktopServices.openUrl(QUrl("https://pypi.org/project/PaIRS-UniNa/"))} if self.TABpar.FlagOutDated>0 else {})    
 
 def downloadLatestVersion(self,app):
     try:
@@ -902,6 +1032,7 @@ def downloadLatestVersion(self,app):
 
 def button_download_PaIRS_action(self,app):
     warningLatestVersion(self,app,flagExit=0,flagWarning=1)
+    checkLatestVersion(self,__version__,self.app,splash=None,flagWarning=0)
     return
     flagStopAndDownload=questionDialog(self,f'A new version of the PaIRS_UniNa package is available. Do you want to close the current instance of {self.name} and download it?')
     if not flagStopAndDownload: return
@@ -913,6 +1044,20 @@ def button_download_PaIRS_action(self,app):
     else: command=''
     subprocess.call(sys.executable+' -m PaIRS_UniNa '+command,shell=True)
     #runPaIRS(self,flagQuestion=False)
+    
+import urllib.request, json, ssl
+
+def get_package_version_urllib(package_name):
+    """Get package version using only standard library"""
+    try:
+        import certifi
+        url = f"https://pypi.org/pypi/{package_name}/json"
+        context = ssl.create_default_context(cafile=certifi.where())
+        with urllib.request.urlopen(url, context=context, timeout=10) as response:
+            data = json.loads(response.read().decode())
+            return True, data['info']['version']
+    except Exception as e:
+        return False, f"Error: {e}"
 
 def checkOutDated(packageName:str,printOutDated):
   ''' 
@@ -944,48 +1089,60 @@ def checkOutDated(packageName:str,printOutDated):
     currentVersion='none'
     latestVersion=''
     try:
-        if Flag_DEBUG:
+        if Flag_ISEXE:
             currentVersion=__version__+'.'+__subversion__ if int(__subversion__) else __version__
         else:
-            command=[sys.executable, '-m', 'pip', 'show', packageName]
-            reqs = subprocess.run(command,capture_output=True)
-            if reqs.returncode:
-                pri.Error.red('Error in command:\n'+' '.join(command)+'\n'+reqs.stderr.decode("utf-8") )
-                return flagOutDated,currentVersion,latestVersion  
-            printing=reqs.stdout.decode("utf-8") 
-            pri.Info.cyan( printing )
-            r=reqs.stdout.decode("utf-8").replace('\r','').split('\n')
-            currentVersion='none'
-            for s in r:
-                if 'Version: ' in s:
-                    currentVersion=s.replace('Version: ','')
-                    break
+            if Flag_DEBUG:
+                currentVersion=__version__+'.'+__subversion__ if int(__subversion__) else __version__
+            else:
+                command=[sys.executable, '-m', 'pip', 'show', packageName]
+                reqs = subprocess.run(command,capture_output=True)
+                if reqs.returncode:
+                    pri.Error.red('Error in command:\n'+' '.join(command)+'\n'+reqs.stderr.decode("utf-8") )
+                    return flagOutDated,currentVersion,latestVersion  
+                printing=reqs.stdout.decode("utf-8") 
+                pri.Info.cyan( printing )
+                r=reqs.stdout.decode("utf-8").replace('\r','').split('\n')
+                currentVersion='none'
+                for s in r:
+                    if 'Version: ' in s:
+                        currentVersion=s.replace('Version: ','')
+                        break
         if currentVersion!=__version__:
             message=f'Greetings, developer!\nThe version of the current instance of PaIRS_UniNa ({__version__}) is different from that installed in the present Python environment ({currentVersion})!\nYou should contact Tommaso and Gerardo if some relevant change is made by yourself!'
             pri.Info.yellow(f'{"-"*50}\n{message}\n{"-"*50}\n')
-        command=[sys.executable, '-m', 'pip', 'index','versions',packageName]
-        reqs = subprocess.run(command,capture_output=True)
-        if not reqs.returncode:
-            printing=reqs.stdout.decode("utf-8") 
-            pri.Info.cyan( printing )
-            r=reqs.stdout.decode("utf-8").replace('\r','').split('\n')
-            #currentVersion=r[0].replace(packageName,'').replace('(','').replace(')','').replace(' ','')
-            latestVersion=r[1].replace('Available versions: ','').split(',')[0]
+        if Flag_ISEXE:
+             _, latestVersion = get_package_version_urllib("PaIRS_UniNa")
         else:
-            pri.Error.red('Error in command:\n'+' '.join(command)+'\n'+reqs.stderr.decode("utf-8") )
-            
-            command=[sys.executable, '-m', 'pip', 'list','--outdated']
+            command=[sys.executable, '-m', 'pip', 'index', 'versions', packageName]
             reqs = subprocess.run(command,capture_output=True)
-            if reqs.returncode:
-                pri.Error.red('Error in command:\n'+' '.join(command)+'\n'+reqs.stderr.decode("utf-8") )
-                return flagOutDated,currentVersion,latestVersion  
-            outDated = [r.decode().split('==')[0] for r in reqs.stdout.split()]
-            if packageName in outDated:
-                i=outDated.index(packageName)
-                latestVersion=outDated[i+2]
+            if not reqs.returncode:
+                printing=reqs.stdout.decode("utf-8") 
+                pri.Info.cyan( printing )
+                r=reqs.stdout.decode("utf-8").replace('\r','').split('\n')
+                #currentVersion=r[0].replace(packageName,'').replace('(','').replace(')','').replace(' ','')
+                latestVersion=r[1].replace('Available versions: ','').split(',')[0]
             else:
-                latestVersion=currentVersion
-            pri.Info.cyan(f'{packageName} ({currentVersion}). Latest version available: {latestVersion}')
+                flagOk,latestVersion=get_package_version_urllib(packageName)
+                if not flagOk:
+                    pri.Error.red('Error in command:\n'+' '.join(command)+'\n'+reqs.stderr.decode("utf-8") )
+                    pri.Error.red(latestVersion)
+                    latestVersion='none'
+                
+                """
+                command=[sys.executable, '-m', 'pip', 'list','--outdated']
+                reqs = subprocess.run(command,capture_output=True)
+                if reqs.returncode:
+                    pri.Error.red('Error in command:\n'+' '.join(command)+'\n'+reqs.stderr.decode("utf-8") )
+                    return flagOutDated,currentVersion,latestVersion  
+                outDated = [r.decode().split('==')[0] for r in reqs.stdout.split()]
+                if packageName in outDated:
+                    i=outDated.index(packageName)
+                    latestVersion=outDated[i+2]
+                else:
+                    latestVersion=currentVersion
+                pri.Info.cyan(f'{packageName} ({currentVersion}). Latest version available: {latestVersion}')
+                """
         #flagOutDated=1 if currentVersion!=latestVersion else 0
         cV_parts=[int(c) for c in currentVersion.split('.')]
         lV_parts=[int(c) for c in latestVersion.split('.')]
@@ -1165,6 +1322,19 @@ def resetRequiredPackagesFile(filename=rqrdpckgs_filename):
             else:
                 pri.Error.red(f"resetRequiredPackagesFile: Skipping malformed line: {line}")
 
+def to_triplet(v: Version) -> tuple[int,int,int]:
+    r = v.release or (0,)
+    return (r[0], r[1] if len(r) > 1 else 0, r[2] if len(r) > 2 else 0)
+
+def le_ver(a: Version, b: Version) -> bool:
+    a1,a2,a3 = to_triplet(a)
+    b1,b2,b3 = to_triplet(b)
+    if a1 > b1: return False
+    if a1 < b1: return True
+    if a2 > b2: return False
+    if a2 < b2: return True
+    return a3 <= b3
+
 def checkRequiredPackages(self, filename=rqrdpckgs_filename, FlagDisplay=False, FlagForcePrint=False):
     required_packages = []
     vmin_list = []
@@ -1199,7 +1369,7 @@ def checkRequiredPackages(self, filename=rqrdpckgs_filename, FlagDisplay=False,
             Flag = True
 
             # Check if within [vmin, vmax]
-            if not (vmin_list[i] <= installed_version <= vmax_list[i]):
+            if not (le_ver(vmin_list[i],installed_version) and le_ver(installed_version,vmax_list[i])):
                 """
                 warnings.append(
                     f"- {pkg}: installed = {installed_version}, target range = [{vmin_list[i]}, {vmax_list[i]}]"
@@ -1216,7 +1386,8 @@ def checkRequiredPackages(self, filename=rqrdpckgs_filename, FlagDisplay=False,
             "Some installed packages have a version outside the target range used to develop "
             "the current release of the PaIRS_UniNa package.\n\n"
             "This may lead to compatibility issues. If you experience unexpected behavior, "
-            "it is recommended to either reinstall the last tested compatible versions."
+            "it is recommended to either reinstall the last tested compatible versions or "
+            f"download the executable at {EXEurl}."
             f" If any issue occurs, please contact the authors at {__mail__}.\n\n"
             #"or use the standalone executable available at:\n"
             #"https://pairs.unina.it/#download\n\n"

PaIRS_UniNa/Process_Tab.py

@@ -724,7 +724,7 @@ class Process_Tab(gPaIRS_Tab):
 #******************** Actions     
     def edit_Wind_vectors(self,wedit:QLineEdit,wlab:QLabel):
         text=wedit.text()
-        split_text=re.split('(\d+)', text)[1:-1:2]
+        split_text=re.split(r'(\d+)', text)[1:-1:2]
         vect=[int(i) for i in split_text]
         FlagEmpty=len(vect)==0
         if FlagEmpty: FlagError=True
@@ -1291,7 +1291,7 @@ class Process_Tab(gPaIRS_Tab):
 
     def line_edit_IW_action(self):
         text=self.ui.line_edit_IW.text()
-        split_text=re.split('(\d+)', text)[1:-1:2]
+        split_text=re.split(r'(\d+)', text)[1:-1:2]
         vect=[int(split_text[i]) for i in (0,2,1,3)]
         if len(vect)==4:
             k=self.PROpar.row

PaIRS_UniNa/Process_Tab_Disp.py

@@ -133,7 +133,7 @@ class Process_Tab_Disp(gPaIRS_Tab):
 #******************** Actions
     def line_edit_IW_action(self):
         text=self.ui.line_edit_IW.text()
-        split_text=re.split('(\d+)', text)[1:-1:2]
+        split_text=re.split(r'(\d+)', text)[1:-1:2]
         split_num=[int(t) for t in split_text]
         if len(split_num)<4: split_num+=[split_num[-1]]*(4-len(split_num))
         vect=[int(split_num[i]) for i in (0,2,1,3)]

PaIRS_UniNa/SPIVCalHelp.py

@@ -0,0 +1,155 @@
+from PySide6 import QtWidgets, QtGui, QtCore
+import sys
+from .PaIRS_pypacks import icons_path, fontPixelSize
+
+def showSPIVCalHelp(parent=None,disable_callback=None):
+    """
+    Shows an informational dialog explaining the correct calibration setup
+    for stereoscopic PIV in PaIRS, ensuring compatibility with disparity
+    correction and full stereoscopic reconstruction.
+    """
+    dlg = QtWidgets.QDialog(parent)
+    dlg.setWindowTitle("Guidelines for stereoscopic PIV calibration")
+    #dlg.resize(900, 750)
+    dlg.setMinimumWidth(900)
+    dlg.setMinimumHeight(750)
+
+    main_layout = QtWidgets.QVBoxLayout(dlg)
+
+    # --- Explanatory text (English, corrected axes) ---
+    text = (
+        "For stereoscopic PIV, PaIRS assumes that:<br><br>"
+
+        "&nbsp;&nbsp;• the <b>calibration plate defines "
+        "the x–y plane</b> of the calibration coordinate system;<br>"
+        
+        "&nbsp;&nbsp;• the <b>x-axis</b> is <b>aligned with the stereoscopic baseline</b>, i.e. "
+        "the direction along which the projections of the two camera viewing rays diverge "
+        "on the calibration plate (the dominant disparity direction);<br>"
+
+        "&nbsp;&nbsp;• the <b>y-axis</b> is then defined as the axis <b>perpendicular to the plane containing "
+        "the two cameras</b> (i.e. perpendicular to the triangulation plane formed by the two "
+        "optical axes);<br>"
+
+        "&nbsp;&nbsp;• the <b>z-axis is normal to the plate</b> (typically pointing towards the cameras).<br><br>"
+
+        "To ensure full compatibility with the operations performed in the disparity correction step and the stereoscopic reconstruction,"
+        " the calibration procedure must always adhere to the above coordinate convention.<br>"
+        " The example below shows a <b>correct</b> configuration (left) and an <b>incorrect</b> one (right).<br>"
+    )
+
+    text_label = QtWidgets.QLabel()
+    text_label.setWordWrap(True)
+    text_label.setTextFormat(QtCore.Qt.RichText)
+    text_label.setText(f"<div>{text}</div>")
+    main_layout.addWidget(text_label)
+    font=dlg.font()
+    font.setPixelSize(fontPixelSize+4)
+    text_label.setFont(font)
+
+    # --- Side-by-side images ---
+    img_layout = QtWidgets.QHBoxLayout()
+    img_layout.setSpacing(10)
+    main_layout.addLayout(img_layout)
+
+    # Paths to images (adjust to match PaIRS resources folder)
+    img_ok_path = icons_path+"spiv_setup_ok.png"
+    img_no_path = icons_path+"spiv_setup_no.png"
+
+    # --- Correct configuration image ---
+    ok_widget = QtWidgets.QVBoxLayout()
+    ok_caption = QtWidgets.QLabel()
+    caption_text = "<b>Correct configuration (x–z stereo plane)</b>"
+    ok_caption.setText(f"<div>{caption_text}</div>")
+    ok_caption.setFont(font)
+    ok_caption.setTextFormat(QtCore.Qt.RichText)
+    ok_caption.setAlignment(QtCore.Qt.AlignCenter)
+
+    ok_label_img = QtWidgets.QLabel()
+    ok_label_img.setAlignment(QtCore.Qt.AlignCenter)
+    ok_label_img.setSizePolicy(QtWidgets.QSizePolicy.Expanding, QtWidgets.QSizePolicy.Expanding)
+    ok_label_img.setScaledContents(True)
+    
+    ok_pix = QtGui.QPixmap(img_ok_path)
+    if not ok_pix.isNull():
+        ok_pix = ok_pix.scaledToWidth(400, QtCore.Qt.SmoothTransformation)
+        ok_label_img.setPixmap(ok_pix)
+    ok_label_img.setFixedSize(ok_pix.width(),ok_pix.height())
+
+    ok_widget.addWidget(ok_caption)
+    ok_widget.addWidget(ok_label_img)
+    img_layout.addLayout(ok_widget)
+
+    # --- Incorrect configuration image ---
+    no_widget = QtWidgets.QVBoxLayout()
+    no_caption = QtWidgets.QLabel()
+    caption_text = "<b>Incorrect configuration</b>"
+    no_caption.setText(f"<div'>{caption_text}</div>")
+    no_caption.setFont(font)
+    no_caption.setTextFormat(QtCore.Qt.RichText)
+    no_caption.setAlignment(QtCore.Qt.AlignCenter)
+
+    no_label_img = QtWidgets.QLabel()
+    no_label_img.setAlignment(QtCore.Qt.AlignCenter)
+    no_label_img.setSizePolicy(QtWidgets.QSizePolicy.Expanding, QtWidgets.QSizePolicy.Expanding)
+    no_label_img.setScaledContents(True)
+    
+    no_pix = QtGui.QPixmap(img_no_path)
+    if not no_pix.isNull():
+        no_pix = no_pix.scaledToWidth(400, QtCore.Qt.SmoothTransformation)
+        no_label_img.setPixmap(no_pix)
+    no_label_img.setFixedSize(no_pix.width(),no_pix.height())
+
+    no_widget.addWidget(no_caption)
+    no_widget.addWidget(no_label_img)
+    img_layout.addLayout(no_widget)
+
+    # Prevent bottom clipping: allow images row to shrink/expand as needed
+    main_layout.setStretch(0, 1)
+    main_layout.setStretch(1, 0)
+
+    # Create a horizontal layout for buttons
+    button_layout = QtWidgets.QHBoxLayout()
+
+    # Spacer pushes OK to the right
+    button_layout.addStretch(1)
+
+    # Left button
+    if disable_callback is not None:
+        button_disable = QtWidgets.QPushButton("Don't show this message again")
+        def on_disable():
+            disable_callback()
+            dlg.accept()
+        button_disable.clicked.connect(on_disable)
+        button_layout.addWidget(button_disable)
+
+    # Right button (OK)
+    button_ok = QtWidgets.QPushButton("OK")
+    def on_ok():
+        dlg.accept()
+    button_ok.clicked.connect(on_ok)
+    button_layout.addWidget(button_ok)
+
+    # Add the layout to the dialog
+    main_layout.addSpacing(12)
+    main_layout.addLayout(button_layout)
+
+    button_ok.setDefault(True)
+    button_ok.setFocus()
+
+    main_layout.setContentsMargins(20, 25, 20, 25)  # slightly larger bottom margin to avoid macOS clipping
+
+    dlg.exec()
+
+if __name__ == "__main__":
+    # QApplication MUST be created before any QWidget
+    app = QtWidgets.QApplication(sys.argv)
+
+    # Parent window (optional)
+    main_window = QtWidgets.QMainWindow()
+    main_window.show()
+
+    # Show the SPIV calibration dialog
+    showSPIVCalHelp(parent=main_window)
+
+    sys.exit(app.exec())