Update the Filename class.

Alain Klotz
1 parent 127eb18e
Showing 6 changed files with 600 additions and 178 deletions Show diff stats
docs/source/index.rst
src/guitastro/__init__.py
src/guitastro/filenames.py
src/guitastro/ima.py
src/guitastro/imaseries.py
src/guitastro/imastack.py
@@ -30,8 +30,8 @@ The source code of Guitastro is available using `Git &lt;https://git-scm.com/&gt;`_.
 Windows users can install `Tortoige Git <https://tortoisegit.org/>`_ which is user friendly.
  
 You can get Guitastro anywhere in your computer. The examples of this guide consider
-to place Guitastro in the folder Documents of your user. Of the user is xxx
-for linux will install guitastro in the folder /home/xxx/Documents. For
+to place Guitastro in the folder Documents of your user. If the user is xxx
+for linux you have to install guitastro in the folder /home/xxx/Documents. For
 Windows users it corresponds to C:\\Users\\xxx\\Documents
  
 Clone the code from the Git repository `https://gitlab.irap.omp.eu/guitastrolib/guitastro.git <https://gitlab.irap.omp.eu/guitastrolib/guitastro.git>`_.
@@ -49,6 +49,21 @@ guitastro.targets
 .. automodule:: guitastro.targets
    :members:
  
+guitastro.ephemeris
+-------------------
+.. automodule:: guitastro.ephemeris
+   :members:
+
+guitastro.filenames
+-------------------
+.. automodule:: guitastro.filenames
+   :members:
+
+guitastro.astrotables
+---------------------
+.. automodule:: guitastro.astrotables
+   :members:
+
 guitastro.camera
 -----------------
 .. automodule:: guitastro.camera
@@ -74,10 +89,6 @@ guitastro.etc
 .. automodule:: guitastro.etc
    :members:
  
-guitastro.ephemeris
--------------------
-.. automodule:: guitastro.ephemeris
-   :members:
  
 guitastro.visu
 --------------
@@ -99,16 +110,6 @@ guitastro.voevent
 .. automodule:: guitastro.voevent
    :members:
  
-guitastro.filenames
--------------------
-.. automodule:: guitastro.filenames
-   :members:
-
-guitastro.astrotables
----------------------
-.. automodule:: guitastro.astrotables
-   :members:
-
 guitastro.splinefit
 -------------------
 .. automodule:: guitastro.splinefit
@@ -20,6 +20,7 @@ client.notify_all(message)
 import os, glob, sys
 import datetime
 import math
+#import inspect
  
 import tkinter as tk
 from tkinter.filedialog import askopenfilename, asksaveasfilename
@@ -107,6 +108,7 @@ class Filenames(FilenamesException, GuitastroTools):
         self._verbose_level = self.VERBOSE_NONE
         self._longiau_deg = 0.0
         self._naming = self.NAMING_NONE
+        self._outfilename = os.path.join(self._image_dir, "noname"+self.extension())
  
     def __repr__(self):
         return str(self)
@@ -118,6 +120,8 @@ class Filenames(FilenamesException, GuitastroTools):
     def longitude(self, longiau_deg:float):
         """ Set the longitude of the observation siteobs.
  
+        This method is useful for the method get_night().
+
         Args:
             longiau_deg: The longitude of the siteobs must expressed in degrees, east increasing, from 0 to 360 (IAU convention).
  
@@ -213,22 +217,58 @@ class Filenames(FilenamesException, GuitastroTools):
             print(fn.naming_rules())
  
         """
+        date_iso = datetime.datetime.utcnow().isoformat()
+        name = self._naming_list[self._naming]
         texte = ""
-        texte +=f"Naming rules for {self._naming_list[self._naming]}\n\n"
         if self._naming == self.NAMING_NONE:
-            texte += "No specific rule.\n"
+            texte += "Filename naming rules\n"
+        else:
+            texte +=f"Filename naming rules for {name}\n"
+        date_iso = datetime.datetime.utcnow().isoformat()
+        texte += "Updated on 2022-11-19T12:48:00\n"
+        texte +=f"Written on {date_iso}\n"
+        # ---
+        h1 = "1. Introduction"
+        texte +=f"\n{h1}\n" + "="*len(h1) + "\n\n"
+        if self._naming == self.NAMING_NONE:
+            texte += "No specific rule. File names can be formed as you want.\n"
+            return texte
+        elif self._naming == self.NAMING_PYROS1:
+            texte +=f"{name} is a file name format for the Python Robotic Observatory Software.\n"
+            texte += "Specific terminology:\n"
+            texte += "* Unit: The set of Mount and Channels that define a 'telescope'.\n"
+            texte += "* Channel: An optical path + camera of a Unit. A unit can have many Channels.\n"
+            texte += "* Album: A set of Channels for which data can be combined by post processing.\n"
+            texte += "* Sequence: A set of Albums. A sequence is a hierarchy Channels/Planes/Frames.\n"
+            texte += "* Plane: A set of Frames. A Plane is composed by Frames.\n"
+            texte += "* Frame: A unitary record (e.g. an image).\n"
+        # ---
+        h1 = "2. Format of the file names"
+        texte +=f"\n{h1}\n" + "="*len(h1) + "\n\n"
         if self._naming == self.NAMING_PYROS1:
-            texte +="          1         2         3         4\n"
-            texte += "0123456789 123456789 123456789 123456789 12345\n"
-            texte += "TT_YYYYMMDD_hhmmsscccccc_UUU_V_CCC_IIIIIIIIII\n"
+            texte += "          1         2         3         4         5\n"
+            texte += "0123456789 123456789 123456789 123456789 123456789 12\n"
+            texte += "TT_YYYYMMDD_hhmmsscccccc_V_UUU_CCC_IIIIIIIIII_PPP_FFF\n"
             texte += "\n"
             texte +=f"TT = 'ftype' = file type amongst {self._naming_0_stypes}\n"
             texte += "YYYYMMDD = 'date' = Year Month Day. e.g. 20221109\n"
             texte += "hhmmsscccccc = 'time' = Hours Minutes Seconds Microseconds. e.g. 235604123456\n"
-            texte += "UUU = 'unit' = Telescope unit. e.g. TNC\n"
             texte += "V = 'version' = Version of the naming rule. e.g. 1\n"
+            texte += "UUU = 'unit' = Telescope unit. e.g. TNC\n"
             texte += "CCC = 'channel' = Optical channel designation. e.g. CH1\n"
             texte += "IIIIIIIIII = 'id_seq' = ID of the file in the database. e.g. 0000001234\n"
+            texte += "PPP = 'plane' = index of the plane. e.g. 001\n"
+            texte += "FFF = 'frame' = index of the frame. e.g. 012\n"
+        # ---
+        h1 = "3. Remarks"
+        texte +=f"\n{h1}\n" + "="*len(h1) + "\n\n"
+        if self._naming == self.NAMING_PYROS1:
+            texte += "Example: L0_20221109_235406123456_1_TNC_CH1_0123456789_001_001\n"
+            texte += "UUU, CCC are accronyms (string)\n"
+            texte += "V, IIIIIIIIII, PPP, FFF are digits (int)\n"
+            texte += "CCC is a Channel for L0,L1 ftype levels but should by the Album for L2 level"
+        # ---
+        texte += "\n\n=== End of the Document ==="
         return texte
  
     def naming_ident(self, fname:str) -> dict:
@@ -245,22 +285,24 @@ class Filenames(FilenamesException, GuitastroTools):
         ::
  
             fn = Filenames()
-            fn.naming_ident("L0_20221109_235406123456_TNC_1_CH1_0123456789")
+            fn.naming_ident("L0_20221109_235406123456_1_TNC_CH1_0123456789_001_001")
             >>> 'PyROS.1'
         """
         naming = self.NAMING_NONE
         n = len(fname)
-        if n == 45:
+        if n == 53:
             words = fname.split("_")
             n = len(words)
-            if n == 7:
+            if n == 9:
                 param['ftype'] = words[0]
                 param['date'] = words[1]
                 param['time'] = words[2]
-                param['unit'] = words[3]
-                param['version'] = words[4]
+                param['version'] = words[3]
+                param['unit'] = words[4]
                 param['channel'] = words[5]
                 param['id_seq'] = words[6]
+                param['plane'] = words[7]
+                param['frame'] = words[8]
                 try:
                     fname_verified = self.naming_set(**param)
                     if fname == fname_verified:
@@ -284,9 +326,9 @@ class Filenames(FilenamesException, GuitastroTools):
  
             fn = Filenames()
             fn.naming("PyROS.1")
-            params = fn.naming_get("L0_20221109_235406123456_TNC_1_CH1_0123456789")
+            params = fn.naming_get("L0_20221109_235406123456_1_TNC_CH1_0123456789_001_012")
  
-        The answer (params dict) should be {'ftype': 'L0', 'date': '20221109', 'time': '235406123456', 'unit': 'TNC', 'version': '1', 'channel': 'CH1', 'id_seq': '0123456789'}
+        The answer (params dict) should be {'ftype': 'L0', 'date': '20221109', 'time': '235406123456', 'version': '1', 'unit': 'TNC', 'channel': 'CH1', 'id_seq': '0123456789', 'plane': '001', 'frame': '012'}
         """
         param = {}
         see_rules = self._see_rules
@@ -294,21 +336,25 @@ class Filenames(FilenamesException, GuitastroTools):
             param['fname'] = fname
         elif self._naming == self.NAMING_PYROS1:
             n = len(fname)
-            if n != 45:
-                texte = "File name must be a string of 45 characters" + see_rules
+            nn = 53
+            if n != nn:
+                texte =f"File name must be a string of {nn} characters" + see_rules
                 raise FilenamesException(FilenamesException.BAD_FILENAME_RULE, texte)
             words = fname.split("_")
             n = len(words)
-            if n != 7:
-                texte = "File name must contain 6 underscore characters" + see_rules
+            nn = 9
+            if n != nn:
+                texte =f"File name must contain {nn-1} underscore characters" + see_rules
                 raise FilenamesException(FilenamesException.BAD_FILENAME_RULE, texte)
             param['ftype'] = words[0]
             param['date'] = words[1]
             param['time'] = words[2]
-            param['unit'] = words[3]
-            param['version'] = words[4]
+            param['version'] = words[3]
+            param['unit'] = words[4]
             param['channel'] = words[5]
             param['id_seq'] = words[6]
+            param['plane'] = words[7]
+            param['frame'] = words[8]
             fname_verified = self.naming_set(**param)
             if fname != fname_verified:
                 raise FilenamesException(FilenamesException.BAD_FILENAME_RULE)
@@ -334,13 +380,16 @@ class Filenames(FilenamesException, GuitastroTools):
             param['ftype'] = "L0"
             param['date'] = "20221109"
             param['time'] = "235406123456"
-            param['unit'] = "TNC"
             param['version'] = "1"
+            param['unit'] = "TNC"
             param['channel'] = "CH1"
             param['id_seq'] = "0123456789"
+            param['plane'] = "001"
+            param['frame'] = "001"
             fname = fn.naming_set(**param)
  
-        The answer should be L0_20221109_235406123456_TNC_1_CH1_0123456789.
+        The answer should be L0_20221109_235406123456_TNC_1_CH1_0123456789_001_001.
+        If param['date'] is "*" then the date and time will be the current UTC time.
         """
         see_rules = self._see_rules
         if self._naming == self.NAMING_NONE:
@@ -353,10 +402,12 @@ class Filenames(FilenamesException, GuitastroTools):
             param['ftype'] = ""
             param['date'] = ""
             param['time'] = ""
-            param['unit'] = ""
             param['version'] = ""
+            param['unit'] = ""
             param['channel'] = ""
             param['id_seq'] = ""
+            param['plane'] = ""
+            param['frame'] = ""
             for key, val in kwargs.items():
                 if key in param.keys():
                     param[key] = val
@@ -376,6 +427,13 @@ class Filenames(FilenamesException, GuitastroTools):
                 if len(param['date']) == 8:
                     if param['date'].isdigit():
                         valid = True
+                elif param['date'] == "*":
+                    d = datetime.datetime.utcnow().isoformat()
+                    fdate = d[0:4]+d[5:7]+d[8:10]
+                    ftime = d[11:13]+d[14:16]+d[17:19]+d[20:26]
+                    param['date'] = fdate
+                    param['time'] = ftime
+                    valid = True
             if valid == False:
                 texte = f"Date {param['date']} must be a string of 8 digits" + see_rules
                 raise FilenamesException(FilenamesException.BAD_PARAM, texte)
@@ -388,24 +446,27 @@ class Filenames(FilenamesException, GuitastroTools):
             if valid == False:
                 texte = f"Date {param['time']} must be a string of 12 digits" + see_rules
                 raise FilenamesException(FilenamesException.BAD_PARAM, texte)
-            # --- verify unit
-            valid = False
-            if isinstance(param['unit'],str):
-                if len(param['unit']) == 3:
-                    valid = True
-            if valid == False:
-                texte = f"Unit {param['unit']} must be a string of 3 characters" + see_rules
-                raise FilenamesException(FilenamesException.BAD_PARAM, texte)
             # --- verify version
             valid = False
             if isinstance(param['version'],str):
                 if len(param['version']) == 1:
                     valid = True
+            elif isinstance(param['version'],int):
+                param['version'] = f"{param['version']:01d}"
+                valid = True
             if valid == False:
                 texte = f"Version {param['version']} must be a string of 1 character" + see_rules
                 raise FilenamesException(FilenamesException.BAD_PARAM, texte)
             # --- verify unit
             valid = False
+            if isinstance(param['unit'],str):
+                if len(param['unit']) == 3:
+                    valid = True
+            if valid == False:
+                texte = f"Unit {param['unit']} must be a string of 3 characters" + see_rules
+                raise FilenamesException(FilenamesException.BAD_PARAM, texte)
+            # --- verify channel
+            valid = False
             if isinstance(param['channel'],str):
                 if len(param['channel']) == 3:
                     valid = True
@@ -417,13 +478,36 @@ class Filenames(FilenamesException, GuitastroTools):
             if isinstance(param['id_seq'],str):
                 if len(param['id_seq']) == 10:
                     valid = True
-            elif isinstance(param['id_seq'],type(int)):
+            elif isinstance(param['id_seq'],int):
                 param['id_seq'] = f"{param['id_seq']:010d}"
                 valid = True
             if valid == False:
                 texte = f"Id_seq {param['id_seq']} must be a string of 10 characters or an integer" + see_rules
                 raise FilenamesException(FilenamesException.BAD_PARAM, texte)
-            fname = param['ftype']+"_"+param['date']+"_"+param['time']+"_"+param['unit']+"_"+param['version']+"_"+param['channel']+"_"+param['id_seq']
+            # --- verify plane
+            valid = False
+            if isinstance(param['plane'],str):
+                if len(param['plane']) == 3:
+                    valid = True
+            elif isinstance(param['plane'],int):
+                param['plane'] = f"{param['plane']:03d}"
+                valid = True
+            if valid == False:
+                texte = f"Plane {param['plane']} must be a string of 3 characters or an integer" + see_rules
+                raise FilenamesException(FilenamesException.BAD_PARAM, texte)
+            # --- verify frame
+            valid = False
+            if isinstance(param['frame'],str):
+                if len(param['frame']) == 3:
+                    valid = True
+            elif isinstance(param['frame'],int):
+                param['frame'] = f"{param['frame']:03d}"
+                valid = True
+            if valid == False:
+                texte = f"Frame {param['frame']} must be a string of 3 characters or an integer" + see_rules
+                raise FilenamesException(FilenamesException.BAD_PARAM, texte)
+            # --- form final file name
+            fname = param['ftype']+"_"+param['date']+"_"+param['time']+"_"+param['version']+"_"+param['unit']+"_"+param['channel']+"_"+param['id_seq']+"_"+param['plane']+"_"+param['frame']
         return fname
  
  
@@ -448,13 +532,13 @@ class Filenames(FilenamesException, GuitastroTools):
         return self._image_dir
  
     def extension(self, extension: str="") -> str:
-        """Set/Get the extension of the FITS files.
+        """Set/Get the extension of the files.
  
         Args:
-            extension: Set the file extension to add automatically to FITS files saved with method save. Defaut value is ".fit".
+            extension: Set the file extension to (usefull add automatically to files when record). Defaut value is ".fit".
  
         Returns:
-            The current extension added to FITS files.
+            The current extension added to files.
  
         """
         if extension != "":
@@ -466,7 +550,7 @@ class Filenames(FilenamesException, GuitastroTools):
     def get_night(self, date: str="now")->str:
         """Get the current night identifier as a string of 8 characters: YYYYMMDD.
  
-        The night identifier changes at local noon. So it used the longitude of the siteobs.
+        The night identifier changes at local noon. So it uses the longitude defined in longitude() method.
  
         Args:
             date: Input date to compute the night identifier. Defaut value is "now".
@@ -476,9 +560,9 @@ class Filenames(FilenamesException, GuitastroTools):
  
         ::
  
-            ima1 = Ima()
-            ima1.longitude = 2.3456
-            night = ima1.get_night("now")
+            fn = Filenames()
+            fn.longitude = 2.3456
+            night = fn.get_night("now")
  
         The variable night contains the current night in the format YYYYMMDD.
         """
@@ -516,8 +600,8 @@ class Filenames(FilenamesException, GuitastroTools):
  
         ::
  
-            ima1 = Ima()
-            fullname = ima1.fullfilename("m57")
+            fn = Filenames()
+            fullname = fn.fullfilename("m57")
  
         The result could be '/srv/develop/guitastro/test/data/m57.fit'
  
@@ -546,8 +630,8 @@ class Filenames(FilenamesException, GuitastroTools):
  
         ::
  
-            ima1 = Ima()
-            fullname = ima1.basename("m57")
+            fn = Filenames()
+            fullname = fn.basename("m57")
  
         The result could be 'm57.fit'
  
@@ -558,11 +642,18 @@ class Filenames(FilenamesException, GuitastroTools):
         basename = os.path.basename(fitsname)
         return basename
  
-    def itername(self, fitsname:str):
-        """Get an iterator according a series of FITS files.
+    def itername(self, fitsname:str, **kwargs):
+        """Get an iterator according a series of files.
+
+        The list of file names is generated internally by the method genename().
  
         Args:
             fitsname: Input file name of a series with or without path or extension.
+            **kwargs: a dictionnary of optional parameters:
+
+                * 'first': Lower index to keep indexes.
+                * 'last': Upper index to keep indexes.
+                * 'indexes': List of indexes to keep (integers).
  
         Returns:
             The iterator of the series of files.
@@ -572,7 +663,8 @@ class Filenames(FilenamesException, GuitastroTools):
  
         ::
  
-            for fitsname in ima1.itername("m63-1"):
+            fn = Filenames()
+            for fitsname in fn.itername("m63-1"):
                 print(f"fitsname={fitsname}")
  
         """
@@ -587,11 +679,18 @@ class Filenames(FilenamesException, GuitastroTools):
             fitsname = os.path.join(dirname, genename + sep + index + suffix + file_extension)
             yield fitsname
  
-    def enumname(self, fitsname: str):
-        """Get an enumerator according a series of FITS files.
+    def enumname(self, fitsname: str, **kwargs):
+        """Get an enumerator according a series of files.
+
+        The list of file names is generated internally by the method genename().
  
         Args:
             fitsname: Input file name of a series with or without path or extension.
+            **kwargs: a dictionnary of optional parameters:
+
+                * 'first': Lower index to keep indexes.
+                * 'last': Upper index to keep indexes.
+                * 'indexes': List of indexes to keep (integers).
  
         Returns:
             The iterator of the series of files.
@@ -601,11 +700,12 @@ class Filenames(FilenamesException, GuitastroTools):
  
         ::
  
-            for k, fitsname in enumarate(ima1.enumname("m63-1")):
+            fn = Filenames()
+            for k, fitsname in enumarate(fn.enumname("m63-1")):
                 print(f"fitsname {k} = {fitsname}")
  
         """
-        dico = self.genename(fitsname)
+        dico = self.genename(fitsname, **kwargs)
         dirname = dico['dirname']
         genename = dico['genename']
         sep = dico['sep']
@@ -631,35 +731,70 @@ class Filenames(FilenamesException, GuitastroTools):
         return filename, file_extension
  
     def genenames(self, wildcard: str)-> dict:
+        """Generate a dictionnary describing a series of files associated to a wildcard file name.
+
+        Generated file names are existing in the disk.
+        This method is similar as genename() but the input file is a wildcard and the output dictionary is different.
+
+        Args:
+            wildcard: Any wildcard with extension. The path is that defined in the method path() is not in the wildcard.
+
+        Returns:
+            A dictionary containing the following keys:
+
+                * 'dirname': Directory name (path only)
+                * 'shortname': Short name (no path, extension)
+                * 'filename': Full name of file (no path, shortname, no extension)
+                * 'ext': Extension of the file
+
+        For example, you have 3 files m63-1.fit, m63-2.fit and m63-3.fit.
+        You have to put one of the three file names as input of the method genename:
+
+        ::
+
+            fn = Filenames()
+            result = fn.genenames("m63-*.fits")
+
+        """
         # fn.genenames("IM_*.fits.gz")
         wildcard = self.fullfilename(wildcard)
-        print(f"wildcard = {wildcard}")
+        #print(f"wildcard = {wildcard}")
         ftmps = glob.glob(wildcard)
         allshortnames = []
         for ftmp in ftmps:
             basename = os.path.basename(ftmp)
+            dirname = os.path.dirname(ftmp)
             allshortnames.append(basename)
         #  ---
         allshorts = []
         for shortname in allshortnames:
             dico = {}
-            nchar = len(shortname)
+            #nchar = len(shortname)
             filename , file_extension = self._split_extension(shortname)
+            dico['dirname'] = dirname
             dico['shortname'] = shortname
             dico['filename'] = filename
             dico['ext'] = file_extension
-            for shortname_ref in allshortnames:
-                nchar_ref = len(shortname_ref)
+            #for shortname_ref in allshortnames:
+            #    nchar_ref = len(shortname_ref)
             allshorts.append(dico)
  
         return allshorts
  
-    def genename(self,fitsname: str)-> dict:
-        """
-        Generate a dictionnary describing a series of files associated to a FITS file name.
+    def genename(self,fitsname: str, **kwargs)-> dict:
+        """Generate a dictionnary describing a series of files associated to a file name.
+
+        The algorithm search for files having indexes with a name similar than fitsname.
+        Generated file names are existing in the disk.
+        This method adds the possibility to restrict indexes using options 'first', 'last' and 'indexes' (using optional parameters).
  
         Args:
             fitsname: Any file name with or without path or extension.
+            **kwargs: a dictionnary of optional parameters:
+
+                * 'first': Lower index to keep indexes.
+                * 'last': Upper index to keep indexes.
+                * 'indexes': List of indexes to keep (integers).
  
         Returns:
             A dictionary containing the following keys:
@@ -676,8 +811,21 @@ class Filenames(FilenamesException, GuitastroTools):
  
         ::
  
-            ima1 = Ima()
-            result = ima1.genename("m63-1")
+            fn = Filenames()
+            result = fn.genename("m63-1")
+
+        The index "1" is not necessary. So the command fn.genename("m63-") gives the same result.
+
+        For example, you have 6 files m63-1.fit, m63-2.fit ... m63-6.fit.
+        You have to put one of the three file names as input of the method genename
+        and if you want to keep only files after the index 4:
+
+        ::
+
+            fn = Filenames()
+            result = fn.genename("m63-1", first=4)
+
+        Indexes of 'first' and 'last' options can be negative (to start from end to begin).
  
         """
         fitsname = self.fullfilename(fitsname)
@@ -766,7 +914,6 @@ class Filenames(FilenamesException, GuitastroTools):
         indexes = []
         if len(ftmps) > 0:
             k = len(genename+sep)
-            indexes = []
             #print(f"2 genename+sep = {genename+sep}")
             #print(f"2 k = {k}")
             nsuffix = len(suffix)
@@ -787,21 +934,212 @@ class Filenames(FilenamesException, GuitastroTools):
             first = indexes[0]
             if first[0] == "0":
                 ndigit = len(first)
-        dico = {}
-        dico["dirname"] = dirname
-        dico["genename"] = genename
-        dico["sep"] = sep
-        dico["indexes"] = indexes
-        dico["suffix"] = suffix
-        dico["file_extension"] = file_extension
-        dico["ndigit"] = ndigit
-        return dico
-
-    def _askopenfilename(self, title=""):
+        genname = {}
+        genname["dirname"] = dirname
+        genname["genename"] = genename
+        genname["sep"] = sep
+        genname["indexes"] = indexes
+        genname["suffix"] = suffix
+        genname["file_extension"] = file_extension
+        genname["ndigit"] = ndigit
+        # --- process optional parameters
+        if len(indexes) > 0:
+            first = int(genname["indexes"][0])
+            n = int(genname["indexes"][-1])
+            if "first" in kwargs.keys():
+                bound = first
+                first = kwargs["first"]
+                if first < 0:
+                    first = n + first + 1
+                if first > n:
+                    first = n
+                if first < bound:
+                    first = bound
+            last = n
+            if "last" in kwargs.keys():
+                last = kwargs["last"]
+                if last < 0:
+                    last = n + last + 1
+                if last < first:
+                    last = first
+                if last > n:
+                    last = n
+            indexes = []
+            for index in genname["indexes"]:
+                rank = int(index)
+                if rank >= first and rank <= last:
+                    if "indexes" in kwargs.keys():
+                        if rank in kwargs["indexes"]:
+                            indexes.append(index)
+                    else:
+                        indexes.append(index)
+            genname["indexes"] = indexes
+        # ---
+        return genname
+
+
+    def innames(self, fitsname, **kwargs):
+        """Same method as genename()
+        """
+        return self.genename(fitsname, **kwargs)
+
+    def inoutnames(self, fitsname, outfilename, **kwargs):
+        """Generate file names informations to process a series of files.
+
+        This method is the same than innames() but add the output names.
+
+        Args:
+            fitsname: Any file name with or without path or extension.
+            outfilename: Generic name of the files that must be created later.
+            **kwargs: a dictionnary of optional parameters:
+
+                * 'first': Lower index to keep indexes.
+                * 'last': Upper index to keep indexes.
+                * 'indexes': List of indexes to keep (integers).
+
+        Returns:
+            A tupple of three elements.
+
+                * A dictionary containing the following keys:
+
+                    * 'dirname': Path name
+                    * 'genename': Generic name of files
+                    * 'sep': Separator between generic name and indexes
+                    * 'indexes': List of indexes sorted increasing
+                    * 'file_extension': File extension
+                    * 'ndigit': Number of digits in case of indexes with leading zeros
+
+                * A string that includes the path and the generic shortname.
+
+                * The extension of the outpout files.
+
+        For example, you have 6 files m63-1.fit, m63-2.fit ... m63-6.fit.
+        You have to put one of the three file names as input of the method genename
+        and if you want to keep only files after the index 4:
+
+        ::
+
+            fn = Filenames()
+            result = fn.inoutnames("m63-1", "i", first=4)
+
+        result can be ({'dirname': '/tmp', 'genename': 'm63', 'sep': '-', 'indexes': ['5', '6'], 'suffix': '', 'file_extension': '.fit', 'ndigit': 0}, '/tmp/j', '.fit')
+        """
+        genename = self.innames(fitsname, **kwargs)
+        # ---
+        outfilename = self.fullfilename(outfilename)
+        outfilegene, outfile_extension = os.path.splitext(outfilename)
+        return genename, outfilegene, outfile_extension
+
+    def outfilename(self, output=""):
+        """Get or set the output file name
+
+        Store the output current filename. Useful for image series or stacking.
+        There is no verification if the file exists.
+
+        Args:
+            output: Any file name with or without path or extension.
+
+        Returns:
+            A string containing the full name of the file (path, shortname, extension).
+
+        ::
+
+            fn = Filenames()
+            fullname = fn.outfilename("j1")
+
+        """
+        fitsname = output
+        if fitsname == "":
+            # --- return the current output name
+            res = self._outfilename
+        else:
+            # --- return a simulation of a output name
+            genename = self.genename(fitsname)
+            outfilename_short = genename["genename"] + genename["file_extension"]
+            outfilename = os.path.join( genename["dirname"], outfilename_short)
+            res = outfilename
+        return res
+
+    def indexnames(self, genename_in, outfilegene, outfile_extension, index, k=""):
+        """Get input and output file names after using genename().
+
+        Generate input and output full file names.
+        Before using this method, use genename() or innames() to generate the genename_in dictionary.
+        There is no verification if the output file exists.
+
+        Args:
+            genename_in: Dictionary generated using the method genename().
+            outfilegene: Generic name (with ou withou path) of the output file
+            outfile_extension: Extension of the output file
+            index: Index if the intput file. Should be one of the elements of genename_in['indexes'].
+            k: Index of the output file. If k is not given, it will be equal to index.
+
+        Returns:
+            A tupple of four elements.
+
+                * A string of the short input file name.
+                * A string of the short output file name.
+                * A string of the full input file name.
+                * A string of the full output file name.
+
+        ::
+
+            fn = Filenames()
+            fn.path = '/tmp'
+            gen = fn.innames("m63-1", first=4)
+            shortin, shortout, fullin, fullout = fn.outfilename(gen, "/tmp/res/j", gen['indexes'][0], 1)
+
+        The results should be shortin='m63-4.fit', shortout='j1.fit', shortin='/tmp/m63-4.fit', shortout='/tmp/res/j1.fit'
+        """
+        filename_short = genename_in["genename"] + genename_in["sep"] + str(index) + genename_in["suffix"] + genename_in["file_extension"]
+        filename = os.path.join( genename_in["dirname"], filename_short)
+        if k=="":
+            kstr = str(index)
+        else:
+            kstr = str(k)
+        outgen = self.genename(outfilegene)
+        outfname = os.path.join(outgen['dirname'],outgen['genename']) + kstr + outgen['suffix'] + outfile_extension
+        basename = os.path.basename(outfname)
+        #called_by = inspect.stack()[1][3]
+        #print(f"ImaSeries.{called_by} {k}/{n} : {filename_short} -> {basename}")
+        return filename_short, basename, filename, outfname
+
+    def deletenames(self, fitsname, **kwargs):
+        """Delete file names from a series of files.
+
+        This method get the file names using innames().
+
+        Args:
+            fitsname: Any file name with or without path or extension.
+            **kwargs: a dictionnary of optional parameters:
+
+                * 'first': Lower index to keep indexes.
+                * 'last': Upper index to keep indexes.
+                * 'indexes': List of indexes to keep (integers).
+
+        Returns:
+            List of deleted files.
+
+        ::
+
+            fn = Filenames()
+            result = fn.deletenames("m63-1", first=4)
+
+        result can be ({'dirname': '/tmp', 'genename': 'm63', 'sep': '-', 'indexes': ['5', '6'], 'suffix': '', 'file_extension': '.fit', 'ndigit': 0}, '/tmp/j', '.fit')
+        """
+        fnames = []
+        for fname in self.itername(fitsname, **kwargs):
+            os.remove(fname)
+            fnames.append(fname)
+        return fnames
+
+    def _askopenfilename(self, title="", filetypes=""):
         root = tk.Tk()
         root.withdraw() # pour ne pas afficher la fenêtre Tk
         initialdir = self._image_dir
-        fitsname = askopenfilename(title=title, initialdir=initialdir, filetypes = [("FITS","*.fit;*.fits;*.fts"),("All", "*")])
+        if filetypes == "":
+            filetypes = [("FITS","*.fit;*.fits;*.fts"),("All", "*")]
+        fitsname = askopenfilename(title=title, initialdir=initialdir, filetypes = filetypes)
         if fitsname != "":
             filename, file_extension = os.path.splitext(fitsname)
             if file_extension=="":
@@ -810,11 +1148,13 @@ class Filenames(FilenamesException, GuitastroTools):
         root.destroy()
         return fitsname
  
-    def _asksaveasfilename(self, title=""):
+    def _asksaveasfilename(self, title="", filetypes=""):
         root = tk.Tk()
         root.withdraw() # pour ne pas afficher la fenêtre Tk
         initialdir = self._image_dir
-        fitsname = asksaveasfilename(title=title, initialdir=initialdir, filetypes = [("FITS","*.fit;*.fits;*.fts"),("All", "*")])
+        if filetypes == "":
+            filetypes = [("FITS","*.fit;*.fits;*.fts"),("All", "*")]
+        fitsname = asksaveasfilename(title=title, initialdir=initialdir, filetypes = filetypes)
         if fitsname != "":
             filename, file_extension = os.path.splitext(fitsname)
             if file_extension=="":
@@ -833,7 +1173,7 @@ class Filenames(FilenamesException, GuitastroTools):
  
 if __name__ == "__main__":
  
-    default = 3
+    default = 4
     example = input(f"Select the example (0 to 3) ({default}) ")
     try:
         example = int(example)
@@ -879,9 +1219,24 @@ if __name__ == &quot;__main__&quot;:
         param['date'] = "20221109"
         param['time'] = "235406123456"
         param['unit'] = "TNC"
-        param['version'] = "1"
+        param['version'] = 1
         param['channel'] = "CH1"
         param['id_seq'] = "0123456789"
+        param['plane'] = 1
+        param['frame'] = 1
         fname = fn.naming_set(**param)
         print(f"fname={fname}")
         param = fn.naming_get(fname)
+
+    if example == 4:
+        """
+        """
+        fn = Filenames()
+        for k in range(2, 10, 1):
+            fname = f"i{k}.fit"
+            print(fname)
+            fname = fn.fullfilename(fname)
+            with open(fname, "wt") as f:
+                pass
+        gen, out, outext = fn.inoutnames("i1", 'j', first=3, last=7)
+        res = fn.indexnames(gen, out, outext, '3', 0)
@@ -67,9 +67,9 @@ from lmfit.models import Model # GaussianModel, LinearModel
 import multiprocessing
  
 try:
-    from .filenames import Filenames, FilenamesException
+    from .filenames import Filenames
 except:
-    from filenames import Filenames, FilenamesException
+    from filenames import Filenames
  
 try:
     from .dates import Date
@@ -86,13 +86,6 @@ try:
 except:
     from wcs import Wcs
  
-"""
-try:
-    from .maps import Maps
-except:
-    from maps import Maps
-"""
-
 try:
     from .astrotables import AstroTable
 except:
@@ -174,6 +167,32 @@ class Ima(ImaException, GuitastroTools):
  
         ima1.offset(100)
  
+    Note:
+
+    The class Ima imports the following methods from the class Filenames. See the Filenames class documentation for these methods:
+
+        * longitude
+        * namings
+        * naming
+        * naming_rules
+        * naming_ident
+        * naming_get
+        * naming_set
+        * path
+        * extension
+        * get_night
+        * fullfilename
+        * basename
+        * itername
+        * enumname
+        * genename
+        * genenames
+        * innames
+        * inoutnames
+        * outfilename
+        * indexnames
+        * deletenames
+
     """
  
     VERBOSE_NONE = 0
@@ -231,6 +250,12 @@ class Ima(ImaException, GuitastroTools):
         self.itername = fn.itername
         self.enumname = fn.enumname
         self.genename = fn.genename
+        self.genenames = fn.genenames
+        self.innames = fn.innames
+        self.inoutnames = fn.inoutnames
+        self.outfilename = fn.outfilename
+        self.indexnames = fn.indexnames
+        self.deletenames = fn.deletenames
         self._askopenfilename = fn._askopenfilename
         self._asksaveasfilename = fn._asksaveasfilename
  
@@ -5,12 +5,17 @@
  
 import numpy as np
 import os
-import inspect
+#import inspect
 from astropy.wcs import WCS
 import multiprocessing
 import psutil
  
 try:
+    from .filenames import Filenames
+except:
+    from filenames import Filenames
+
+try:
     from .ima import Ima
 except:
     from ima import Ima
@@ -43,7 +48,35 @@ class ImaSeriesException(GuitastroException):
  
  
 class ImaSeries(ImaSeriesException, GuitastroTools):
+    """Image processing applied to a series of images.
+
+    This class process a series of images to generate another series of images.
+
+    The class ImaSeries imports the following methods from the class Filenames. See the Filenames class documentation for these methods:
+
+        * longitude
+        * namings
+        * naming
+        * naming_rules
+        * naming_ident
+        * naming_get
+        * naming_set
+        * path
+        * extension
+        * get_night
+        * fullfilename
+        * basename
+        * itername
+        * enumname
+        * genename
+        * genenames
+        * innames
+        * inoutnames
+        * outfilename
+        * indexnames
+        * deletenames
  
+    """
     VERBOSE_NONE = 0
     VERBOSE_SPECIFIC = 1
     VERBOSE_DEBUG = 2
@@ -57,9 +90,31 @@ class ImaSeries(ImaSeriesException, GuitastroTools):
         self._outfilename = os.path.join(self._ima.path(), "noname"+self._ima.extension())
         self._ima.do_multiprocessing = False
         self.do_multiprocessing = True
-
-    def longitude(self, longiau_deg:float):
-        self._ima.longitude(longiau_deg)
+        # --- import Filenames methods
+        fn = Filenames()
+        self.longitude = fn.longitude
+        self.namings = fn.namings
+        self.naming = fn.naming
+        self.naming_rules = fn.naming_rules
+        self.naming_ident = fn.naming_ident
+        self.naming_get = fn.naming_get
+        self.naming_set = fn.naming_set
+        self.path = fn.path
+        self.extension = fn.extension
+        self.get_night = fn.get_night
+        self.fullfilename = fn.fullfilename
+        self.basename = fn.basename
+        self.itername = fn.itername
+        self.enumname = fn.enumname
+        self.genename = fn.genename
+        self.genenames = fn.genenames
+        self.innames = fn.innames
+        self.inoutnames = fn.inoutnames
+        self.outfilename = fn.outfilename
+        self.indexnames = fn.indexnames
+        self.deletenames = fn.deletenames
+        self._askopenfilename = fn._askopenfilename
+        self._asksaveasfilename = fn._asksaveasfilename
  
     def execute_process_type1(self, method_process, process_args, genename, outfilegene, outfile_extension):
         """Generic method for multiprocesses
@@ -119,79 +174,6 @@ class ImaSeries(ImaSeriesException, GuitastroTools):
                 print(message)
  
     # =============================================
-    # Managing filenames
-    # =============================================
-
-    def path(self, path=""):
-        return self._ima.path(path)
-
-    def extension(self, extension=""):
-        return self._ima.extension(extension)
-
-    def outfilename(self, output=""):
-        basename = os.path.basename(self._outfilename)
-        shortname, file_extension = os.path.splitext(basename)
-        res = self._outfilename
-        if output != "":
-            res = shortname
-        return res
-
-    def fullfilename(self,fitsname:str)->str:
-        return self._ima.path(fitsname)
-
-    def basename(self,fitsname:str)->str:
-        return self._ima.basename(fitsname)
-
-    def genename(self,fitsname:str)->str:
-        return self._ima.genename(fitsname)
-
-    def inoutnames(self, fitsname, outfilename, **kwargs):
-        # ---
-        genename = self._ima.genename(fitsname)
-        n = len(genename["indexes"])
-        # ---
-        first = 1
-        if "first" in kwargs.keys():
-            first = kwargs["first"]
-            if first > n:
-                first = n
-        end = n
-        if "end" in kwargs.keys():
-            end = kwargs["end"]
-            if end < first:
-                end = first
-            if end > n:
-                end = n
-        indexes = []
-        for index in genename["indexes"]:
-            rank = int(index)
-            if rank >= first and rank <= end:
-                indexes.append(index)
-        genename["indexes"] = indexes
-        # ---
-        outfilename = self._ima.fullfilename(outfilename)
-        outfilegene, outfile_extension = os.path.splitext(outfilename)
-        #print(f"genename={genename}")
-        #print(f"outfilegene={outfilegene}")
-        #print(f"outfile_extension={outfile_extension}")
-        return genename, outfilegene, outfile_extension
-
-    def indexnames(self, genename, outfilegene, outfile_extension, index, k):
-        n = len(genename["indexes"])
-        filename_short = genename["genename"] + genename["sep"] + index + genename["suffix"] + genename["file_extension"]
-        filename = os.path.join( genename["dirname"], filename_short)
-        outfname = outfilegene + str(k) + outfile_extension
-        basename = os.path.basename(outfname)
-        called_by = inspect.stack()[1][3]
-        print(f"ImaSeries.{called_by} {k}/{n} : {filename_short} -> {basename}")
-        return filename_short, basename, filename, outfname
-
-    def deletenames(self, fitsname):
-        for fname in self._ima.itername(fitsname):
-            print(f"Delete = {fname}")
-            os.remove(fname)
-
-    # =============================================
     # Image processing (pixels are modified)
     # =============================================
  
@@ -9,6 +9,11 @@ import datetime
 import numpy as np
  
 try:
+    from .filenames import Filenames
+except:
+    from filenames import Filenames
+
+try:
     from .ima import Ima
 except:
     from ima import Ima
@@ -43,6 +48,35 @@ class ImaStackException(GuitastroException):
  
  
 class ImaStack(ImaStackException, GuitastroTools):
+    """Image processing applied to a series of images.
+
+    This class process a series of images to generate only one image.
+
+    The class ImaSeries imports the following methods from the class Filenames. See the Filenames class documentation for these methods:
+
+        * longitude
+        * namings
+        * naming
+        * naming_rules
+        * naming_ident
+        * naming_get
+        * naming_set
+        * path
+        * extension
+        * get_night
+        * fullfilename
+        * basename
+        * itername
+        * enumname
+        * genename
+        * genenames
+        * innames
+        * inoutnames
+        * outfilename
+        * indexnames
+        * deletenames
+
+    """
  
     VERBOSE_NONE = 0
     VERBOSE_SPECIFIC = 1
@@ -55,6 +89,31 @@ class ImaStack(ImaStackException, GuitastroTools):
         self._verbose_level = self.VERBOSE_NONE
         self._longiau_deg = 0.0
         self._outfilename = os.path.join(self._ima.path(), "noname"+self._ima.extension())
+        # --- import Filenames methods
+        fn = Filenames()
+        self.longitude = fn.longitude
+        self.namings = fn.namings
+        self.naming = fn.naming
+        self.naming_rules = fn.naming_rules
+        self.naming_ident = fn.naming_ident
+        self.naming_get = fn.naming_get
+        self.naming_set = fn.naming_set
+        self.path = fn.path
+        self.extension = fn.extension
+        self.get_night = fn.get_night
+        self.fullfilename = fn.fullfilename
+        self.basename = fn.basename
+        self.itername = fn.itername
+        self.enumname = fn.enumname
+        self.genename = fn.genename
+        self.genenames = fn.genenames
+        self.innames = fn.innames
+        self.inoutnames = fn.inoutnames
+        self.outfilename = fn.outfilename
+        self.indexnames = fn.indexnames
+        self.deletenames = fn.deletenames
+        self._askopenfilename = fn._askopenfilename
+        self._asksaveasfilename = fn._asksaveasfilename
  
     def longitude(self, longiau_deg:float):
         self._ima.longitude(longiau_deg)