vortex-nwp 2.0.0b1__py3-none-any.whl → 2.0.0b2__py3-none-any.whl

vortex/nwp/algo/ifsroot.py

@@ -5,11 +5,17 @@ Abstract base class for any AlgoComponent leveraging the Arpege/IFS code.
 from bronx.fancies import loggers
 import footprints
 
-from vortex.algo.components import Parallel, ParallelIoServerMixin, AlgoComponentError
+from vortex.algo.components import (
+    Parallel,
+    ParallelIoServerMixin,
+    AlgoComponentError,
+)
 from vortex.syntax.stdattrs import model
 from vortex.tools import grib
 
-from . import ifsnaming  # @UnusedImport
+# footprints import
+from . import ifsnaming as ifsnaming
+
 from ..syntax.stdattrs import algo_member
 from ..tools import satrad, drhook
 
@@ -19,105 +25,122 @@ __all__ = []
 logger = loggers.getLogger(__name__)
 
 
-class IFSParallel(Parallel, ParallelIoServerMixin,
-                  satrad.SatRadDecoMixin, drhook.DrHookDecoMixin, grib.EcGribDecoMixin):
+class IFSParallel(
+    Parallel,
+    ParallelIoServerMixin,
+    satrad.SatRadDecoMixin,
+    drhook.DrHookDecoMixin,
+    grib.EcGribDecoMixin,
+):
     """Abstract IFSModel parallel algo components."""
 
     _abstract = True
     _footprint = [
-        model, algo_member,
+        model,
+        algo_member,
         dict(
-            info = 'Abstract AlgoComponent for anything based on Arpege/IFS.',
-            attr = dict(
-                kind = dict(
-                    info            = 'The kind of processing we want the Arpege/IFS binary to perform.',
-                    default         = 'ifsrun',
-                    doc_zorder      = 90,
+            info="Abstract AlgoComponent for anything based on Arpege/IFS.",
+            attr=dict(
+                kind=dict(
+                    info="The kind of processing we want the Arpege/IFS binary to perform.",
+                    default="ifsrun",
+                    doc_zorder=90,
                 ),
-                model = dict(
-                    values  = ['arpege', 'arp', 'arp_court', 'aladin', 'ald',
-                               'arome', 'aro', 'aearp', 'pearp', 'ifs', 'alaro', 'harmoniearome']
+                model=dict(
+                    values=[
+                        "arpege",
+                        "arp",
+                        "arp_court",
+                        "aladin",
+                        "ald",
+                        "arome",
+                        "aro",
+                        "aearp",
+                        "pearp",
+                        "ifs",
+                        "alaro",
+                        "harmoniearome",
+                    ]
                 ),
-                ioname = dict(
-                    default = 'nwpioserv',
+                ioname=dict(
+                    default="nwpioserv",
                 ),
-                binarysingle = dict(
-                    default = 'basicnwp',
+                binarysingle=dict(
+                    default="basicnwp",
                 ),
-                conf = dict(
-                    info = 'The configuration number given to Arpege/IFS.',
-                    type            = int,
-                    optional        = True,
-                    default         = 1,
-                    doc_visibility  = footprints.doc.visibility.ADVANCED,
+                conf=dict(
+                    info="The configuration number given to Arpege/IFS.",
+                    type=int,
+                    optional=True,
+                    default=1,
+                    doc_visibility=footprints.doc.visibility.ADVANCED,
                 ),
-                timescheme = dict(
-                    info = 'The timescheme that will be used by Arpege/IFS model.',
-                    optional        = True,
-                    default         = 'sli',
-                    values          = ['eul', 'eulerian', 'sli', 'semilag'],
-                    remap           = dict(
-                        eulerian = 'eul',
-                        semilag  = 'sli'
-                    ),
-                    doc_visibility  = footprints.doc.visibility.ADVANCED,
+                timescheme=dict(
+                    info="The timescheme that will be used by Arpege/IFS model.",
+                    optional=True,
+                    default="sli",
+                    values=["eul", "eulerian", "sli", "semilag"],
+                    remap=dict(eulerian="eul", semilag="sli"),
+                    doc_visibility=footprints.doc.visibility.ADVANCED,
                 ),
-                timestep = dict(
-                    info     = 'The timestep of the Arpege/IFS model.',
-                    type     = float,
-                    optional = True,
-                    default  = 600.,
+                timestep=dict(
+                    info="The timestep of the Arpege/IFS model.",
+                    type=float,
+                    optional=True,
+                    default=600.0,
                 ),
-                fcterm = dict(
-                    info     = 'The forecast term of the Arpege/IFS model.',
-                    type     = int,
-                    optional = True,
-                    default  = 0,
+                fcterm=dict(
+                    info="The forecast term of the Arpege/IFS model.",
+                    type=int,
+                    optional=True,
+                    default=0,
                 ),
-                fcunit = dict(
-                    info     = 'The unit used in the *fcterm* attribute.',
-                    optional = True,
-                    default  = 'h',
-                    values   = ['h', 'hour', 't', 'step', 'timestep'],
-                    remap = dict(
-                        hour = 'h',
-                        step = 't',
-                        timestep = 't',
-                    )
+                fcunit=dict(
+                    info="The unit used in the *fcterm* attribute.",
+                    optional=True,
+                    default="h",
+                    values=["h", "hour", "t", "step", "timestep"],
+                    remap=dict(
+                        hour="h",
+                        step="t",
+                        timestep="t",
+                    ),
                 ),
-                xpname = dict(
-                    info = 'The default labelling of files used in Arpege/IFS model.',
-                    optional        = True,
-                    default         = 'XPVT',
-                    doc_visibility  = footprints.doc.visibility.ADVANCED,
+                xpname=dict(
+                    info="The default labelling of files used in Arpege/IFS model.",
+                    optional=True,
+                    default="XPVT",
+                    doc_visibility=footprints.doc.visibility.ADVANCED,
                 ),
-            )
-        )
+            ),
+        ),
     ]
 
     def fstag(self):
         """Extend default tag with ``kind`` value."""
-        return super().fstag() + '.' + self.kind
+        return super().fstag() + "." + self.kind
 
     def valid_executable(self, rh):
         """Be sure that the specifed executable is ifsmodel compatible."""
         valid = super().valid_executable(rh)
         try:
-            return valid and bool(rh.resource.realkind == 'ifsmodel')
+            return valid and bool(rh.resource.realkind == "ifsmodel")
         except (ValueError, TypeError):
             return False
 
     def spawn_hook(self):
         """Usually a good habit to dump the fort.4 namelist."""
         super().spawn_hook()
-        if self.system.path.exists('fort.4'):
-            self.system.subtitle('{:s} : dump namelist <fort.4>'.format(self.realkind))
-            self.system.cat('fort.4', output=False)
+        if self.system.path.exists("fort.4"):
+            self.system.subtitle(
+                "{:s} : dump namelist <fort.4>".format(self.realkind)
+            )
+            self.system.cat("fort.4", output=False)
 
     def spawn_command_options(self):
         """Dictionary provided for command line factory."""
         return dict(
-            name=(self.xpname + 'xxxx')[:4].upper(),
+            name=(self.xpname + "xxxx")[:4].upper(),
             conf=self.conf,
             timescheme=self.timescheme,
             timestep=self.timestep,
@@ -133,19 +156,18 @@ class IFSParallel(Parallel, ParallelIoServerMixin,
         :param actualfmt: The format of the target file.
         :param dict kwargs: Any argument you may see fit.
         """
-        nc_args = dict(model=self.model,
-                       conf=self.conf,
-                       xpname=self.xpname)
+        nc_args = dict(model=self.model, conf=self.conf, xpname=self.xpname)
         nc_args.update(kwargs)
-        nc = footprints.proxy.ifsnamingconv(kind=kind,
-                                            actualfmt=actualfmt,
-                                            cycle=rh.resource.cycle,
-                                            **nc_args)
+        nc = footprints.proxy.ifsnamingconv(
+            kind=kind, actualfmt=actualfmt, cycle=rh.resource.cycle, **nc_args
+        )
         if nc is None:
             raise AlgoComponentError("No IFSNamingConvention was found.")
         return nc
 
-    def do_climfile_fixer(self, rh, convkind, actualfmt=None, geo=None, **kwargs):
+    def do_climfile_fixer(
+        self, rh, convkind, actualfmt=None, geo=None, **kwargs
+    ):
         """Is it necessary to fix the climatology file ? (i.e link in the appropriate file).
 
         :param rh: The binary's ResourceHandler.
@@ -155,16 +177,27 @@ class IFSParallel(Parallel, ParallelIoServerMixin,
         :param dict kwargs: Any argument you may see fit (used to create and call
                             the IFSNamingConvention object.
         """
-        nc = self.naming_convention(kind=convkind, rh=rh, actualfmt=actualfmt, **kwargs)
+        nc = self.naming_convention(
+            kind=convkind, rh=rh, actualfmt=actualfmt, **kwargs
+        )
         nc_args = dict()
         if geo:
-            nc_args['area'] = geo.area
+            nc_args["area"] = geo.area
         nc_args.update(kwargs)
-        return not self.system.path.exists(nc(** nc_args))
-
-    def climfile_fixer(self, rh, convkind,
-                       month, geo=None, notgeo=None, actualfmt=None,
-                       inputrole=None, inputkind=None, **kwargs):
+        return not self.system.path.exists(nc(**nc_args))
+
+    def climfile_fixer(
+        self,
+        rh,
+        convkind,
+        month,
+        geo=None,
+        notgeo=None,
+        actualfmt=None,
+        inputrole=None,
+        inputkind=None,
+        **kwargs,
+    ):
         """Fix the climatology files (by choosing the appropriate month, geometry, ...)
 
         :param rh: The binary's ResourceHandler.
@@ -179,19 +212,25 @@ class IFSParallel(Parallel, ParallelIoServerMixin,
                             the IFSNamingConvention object).
         """
         if geo is not None and notgeo is not None:
-            raise ValueError('*geo* and *notgeo* cannot be provided together.')
+            raise ValueError("*geo* and *notgeo* cannot be provided together.")
 
         def check_month(actualrh):
-            return bool(hasattr(actualrh.resource, 'month') and
-                        actualrh.resource.month == month)
+            return bool(
+                hasattr(actualrh.resource, "month")
+                and actualrh.resource.month == month
+            )
 
         def check_month_and_geo(actualrh):
-            return (check_month(actualrh) and
-                    actualrh.resource.geometry.tag == geo.tag)
+            return (
+                check_month(actualrh)
+                and actualrh.resource.geometry.tag == geo.tag
+            )
 
         def check_month_and_notgeo(actualrh):
-            return (check_month(actualrh) and
-                    actualrh.resource.geometry.tag != notgeo.tag)
+            return (
+                check_month(actualrh)
+                and actualrh.resource.geometry.tag != notgeo.tag
+            )
 
         if geo:
             checker = check_month_and_geo
@@ -200,23 +239,41 @@ class IFSParallel(Parallel, ParallelIoServerMixin,
         else:
             checker = check_month
 
-        nc = self.naming_convention(kind=convkind, rh=rh, actualfmt=actualfmt, **kwargs)
+        nc = self.naming_convention(
+            kind=convkind, rh=rh, actualfmt=actualfmt, **kwargs
+        )
         nc_args = dict()
         if geo:
-            nc_args['area'] = geo.area
+            nc_args["area"] = geo.area
         nc_args.update(kwargs)
-        target_name = nc(** nc_args)
+        target_name = nc(**nc_args)
 
         self.system.remove(target_name)
 
-        logger.info("Linking in the %s file (%s) for month %s.", convkind, target_name, month)
-        rc = self.setlink(initrole=inputrole, initkind=inputkind, inittest=checker,
-                          initname=target_name)
+        logger.info(
+            "Linking in the %s file (%s) for month %s.",
+            convkind,
+            target_name,
+            month,
+        )
+        rc = self.setlink(
+            initrole=inputrole,
+            initkind=inputkind,
+            inittest=checker,
+            initname=target_name,
+        )
         return target_name if rc else None
 
-    def all_localclim_fixer(self, rh, month, convkind='targetclim', actualfmt=None,
-                            inputrole=('LocalClim', 'TargetClim', 'BDAPClim'),
-                            inputkind='clim_bdap', **kwargs):
+    def all_localclim_fixer(
+        self,
+        rh,
+        month,
+        convkind="targetclim",
+        actualfmt=None,
+        inputrole=("LocalClim", "TargetClim", "BDAPClim"),
+        inputkind="clim_bdap",
+        **kwargs,
+    ):
         """Fix all the local/BDAP climatology files (by choosing the appropriate month)
 
         :param rh: The binary's ResourceHandler.
@@ -231,19 +288,33 @@ class IFSParallel(Parallel, ParallelIoServerMixin,
         """
 
         def check_month(actualrh):
-            return bool(hasattr(actualrh.resource, 'month') and
-                        actualrh.resource.month == month)
+            return bool(
+                hasattr(actualrh.resource, "month")
+                and actualrh.resource.month == month
+            )
 
-        nc = self.naming_convention(kind=convkind, rh=rh, actualfmt=actualfmt, **kwargs)
+        nc = self.naming_convention(
+            kind=convkind, rh=rh, actualfmt=actualfmt, **kwargs
+        )
         dealtwith = list()
 
-        for tclimrh in [x.rh for x in self.context.sequence.effective_inputs(
-                role=inputrole, kind=inputkind,
-        ) if x.rh.resource.month == month]:
+        for tclimrh in [
+            x.rh
+            for x in self.context.sequence.effective_inputs(
+                role=inputrole,
+                kind=inputkind,
+            )
+            if x.rh.resource.month == month
+        ]:
             thisclim = tclimrh.container.localpath()
             thisname = nc(area=tclimrh.resource.geometry.area)
             if thisclim != thisname:
-                logger.info("Linking in the %s to %s for month %s.", thisclim, thisname, month)
+                logger.info(
+                    "Linking in the %s to %s for month %s.",
+                    thisclim,
+                    thisname,
+                    month,
+                )
                 self.system.symlink(thisclim, thisname)
                 dealtwith.append(thisname)
 
@@ -251,13 +322,17 @@ class IFSParallel(Parallel, ParallelIoServerMixin,
 
     def find_namelists(self, opts=None):
         """Find any namelists candidates in actual context inputs."""
-        return [x.rh
-                for x in self.context.sequence.effective_inputs(kind=('namelist', 'namelistfp'))]
+        return [
+            x.rh
+            for x in self.context.sequence.effective_inputs(
+                kind=("namelist", "namelistfp")
+            )
+        ]
 
     def _set_nam_macro(self, namcontents, namlocal, macro, value):
         """Set a namelist macro and log it!"""
         namcontents.setmacro(macro, value)
-        logger.info('Setup macro %s=%s in %s', macro, str(value), namlocal)
+        logger.info("Setup macro %s=%s in %s", macro, str(value), namlocal)
 
     def prepare_namelist_delta(self, rh, namcontents, namlocal):
         """Apply a namelist delta depending on the cycle of the binary."""
@@ -268,34 +343,47 @@ class IFSParallel(Parallel, ParallelIoServerMixin,
         nam_updated = False
         # For cy41 onward, replace some namelist macros with the command line
         # arguments
-        if rh.resource.cycle >= 'cy41':
-            if 'NAMARG' in namcontents:
+        if rh.resource.cycle >= "cy41":
+            if "NAMARG" in namcontents:
                 opts_arg = self.spawn_command_options()
-                self._set_nam_macro(namcontents, namlocal, 'CEXP', opts_arg['name'])
-                self._set_nam_macro(namcontents, namlocal, 'TIMESTEP', opts_arg['timestep'])
-                fcstop = '{:s}{:d}'.format(opts_arg['fcunit'], opts_arg['fcterm'])
-                self._set_nam_macro(namcontents, namlocal, 'FCSTOP', fcstop)
+                self._set_nam_macro(
+                    namcontents, namlocal, "CEXP", opts_arg["name"]
+                )
+                self._set_nam_macro(
+                    namcontents, namlocal, "TIMESTEP", opts_arg["timestep"]
+                )
+                fcstop = "{:s}{:d}".format(
+                    opts_arg["fcunit"], opts_arg["fcterm"]
+                )
+                self._set_nam_macro(namcontents, namlocal, "FCSTOP", fcstop)
                 nam_updated = True
             else:
-                logger.info('No NAMARG block in %s', namlocal)
+                logger.info("No NAMARG block in %s", namlocal)
 
         if self.member is not None:
-            for macro_name in ('MEMBER', 'PERTURB'):
-                self._set_nam_macro(namcontents, namlocal, macro_name, self.member)
+            for macro_name in ("MEMBER", "PERTURB"):
+                self._set_nam_macro(
+                    namcontents, namlocal, macro_name, self.member
+                )
             nam_updated = True
         return nam_updated
 
     def prepare_namelists(self, rh, opts=None):
         """Update each of the namelists."""
         namcandidates = self.find_namelists(opts)
-        self.system.subtitle('Namelist candidates')
+        self.system.subtitle("Namelist candidates")
         for nam in namcandidates:
             nam.quickview()
         for namrh in namcandidates:
             namc = namrh.contents
-            if self.prepare_namelist_delta(rh, namc, namrh.container.actualpath()):
+            if self.prepare_namelist_delta(
+                rh, namc, namrh.container.actualpath()
+            ):
                 if namc.dumps_needs_update:
-                    logger.info('Rewritting the %s namelists file.', namrh.container.actualpath())
+                    logger.info(
+                        "Rewritting the %s namelists file.",
+                        namrh.container.actualpath(),
+                    )
                     namc.rewrite(namrh.container)
 
     def prepare(self, rh, opts):
@@ -306,6 +394,6 @@ class IFSParallel(Parallel, ParallelIoServerMixin,
 
     def execute_single(self, rh, opts):
         """Standard IFS-Like execution parallel execution."""
-        if rh.resource.cycle < 'cy46':
-            self.system.ls(output='dirlst')
+        if rh.resource.cycle < "cy46":
+            self.system.ls(output="dirlst")
         super().execute_single(rh, opts)