Update configuration references and improve logging in ensemble example

- Corrected template file name in driver.py from `simpletemplate.conf` to `template.conf`.
- Replaced service info logging with print statements in instance_component.py for better visibility during execution.
- Added USE_PORTAL configuration option in platform.conf.
- Expanded README.md to provide clearer instructions and details about the ensemble example.

Author: markcoletti

examples-proposed/020-simple-ensemble/README.md

@@ -1 +1,26 @@
-# Simple ensemble example shows how to create an ensemble
+# Simple ensemble example 
+
+This shows how to run an ensemble for three instances.
+
+Note that there will be Dask related errors and warnings at the end that can be
+ignored.  These are due to Dask not having a clean shutdown.
+
+## Contents
+
+* `__init__.py` -- empty python init file
+* `driver.py` -- top-level driver
+* `instance_component.py` -- component worker code
+* `instance_driver.py` -- component driver code
+
+* `ensemble.conf` -- top-level configuration file
+* `platform.conf` -- platform configuration file
+* `template.conf` -- ensemble instance configuration file
+
+
+## Instructions
+
+To run the code, run:
+
+```bash
+ips.py --platform platform.conf --simulation ensemble.conf
+```

examples-proposed/020-simple-ensemble/driver.py

@@ -32,7 +32,7 @@ def step(self, timestamp=0.0):
         # correspond to the variable values.  Naturally, the size of the lists
         # should be identical. Note that placeholders for these variables must
         # be defined in a special template IPS configuration file, in this case,
-        # `simpletemplate.conf`.
+        # `template.conf`.
         variables = {
                 'instance_component': {
                         'A': [3, 2, 4],

examples-proposed/020-simple-ensemble/instance_component.py

@@ -12,12 +12,12 @@ def step(self, timestamp: float = 0.0, **keywords):
         # the `run_ensemble()` `name` argument prepended to a unique number
         # for each instance.  E.g., ENSEMBLE_INSTANCE might be "MY_INSTANCE_23".
         instance_id = self.services.get_config_param('ENSEMBLE_INSTANCE')
-        self.services.info(f'{instance_id}: Start of step of instance '
-                           f'component.')
-        
+        print(f'{instance_id}: Start of step of instance '
+              f'component.')
+
         # Echo the parameters we're expecting, A, B, and C
-        self.services.info(f'{instance_id}: instance component parameters: '
-                           f'A={self.A}, B={self.B}, C={self.C}')
+        print(f'{instance_id}: instance component parameters: '
+              f'A={self.A}, B={self.B}, C={self.C}')
 
-        self.services.info(f'{instance_id}: End of step of instance '
-                           f'component.')
+        print(f'{instance_id}: End of step of instance '
+              f'component.')

examples-proposed/020-simple-ensemble/platform.conf

@@ -5,4 +5,5 @@ CORES_PER_NODE = 2
 SOCKETS_PER_NODE = 1
 NODE_ALLOCATION_MODE =  shared
 HOST = localhost
-SCRATCH = 
+USE_PORTAL = False
+SCRATCH =