src/scripts/model_maker.py

 #!/usr/bin/env python3
 
-#   Copyright (C) 2024   INAF - Osservatorio Astronomico di Cagliari
+#   Copyright (C) 2025   INAF - Osservatorio Astronomico di Cagliari
 #
 #   This program is free software: you can redistribute it and/or modify
 #   it under the terms of the GNU General Public License as published by
@@ -145,7 +145,11 @@ def load_model(model_file):
         print("ERROR: " + model_file + " was not found!")
     if model is not None:
         max_rad = 0.0
-        make_3d = False if model['system_settings']['make_3D'] == "0" else True
+        make_3d = False
+        try:
+            if model['system_settings']['make_3D'] == "0" else True
+        except KeyError:
+            make_3d = False
         if (make_3d and not allow_3d):
             print("WARNING: 3D visualization of models is not available. Disabling.")
             make_3d = False
@@ -367,9 +371,11 @@ def load_model(model_file):
             if (len_vec_x == 0):
                 # Generate random cluster
                 rnd_seed = int(model['system_settings']['rnd_seed'])
-                max_rad = float(model['particle_settings']['max_rad'])
-                # random_aggregate() checks internally whether application is INCLUSION
-                #random_aggregate(sconf, gconf, rnd_seed, max_rad)
+                try:
+                    max_rad = float(model['particle_settings']['max_rad'])
+                except KeyError:
+                    print("ERROR: random model generation requires specification of particle_settings:max_rad.")
+                    return (None, None)
                 rnd_engine = "COMPACT"
                 try:
                     rnd_engine = model['system_settings']['rnd_engine']
@@ -382,6 +388,7 @@ def load_model(model_file):
                         print("ERROR: compact random generator works only when all sphere types have the same radius.")
                         return (None, None)
                 elif (rnd_engine == "LOOSE"):
+                    # random_aggregate() checks internally whether application is INCLUSION
                     check = random_aggregate(sconf, gconf, rnd_seed, max_rad)
                 else:
                     print("ERROR: unrecognized random generator engine.")

src/scripts/pycompare.py

-#!/bin/python3
+#!/usr/bin/env python3
 
-#   Copyright (C) 2024   INAF - Osservatorio Astronomico di Cagliari
+#   Copyright (C) 2025   INAF - Osservatorio Astronomico di Cagliari
 #
 #   This program is free software: you can redistribute it and/or modify
 #   it under the terms of the GNU General Public License as published by

src/scripts/pydynrange.py

-#!/bin/python3
+#!/usr/bin/env python3
 
-#   Copyright (C) 2024   INAF - Osservatorio Astronomico di Cagliari
+#   Copyright (C) 2025   INAF - Osservatorio Astronomico di Cagliari
 #
 #   This program is free software: you can redistribute it and/or modify
 #   it under the terms of the GNU General Public License as published by

src/scripts/pytiming.py

-#!/bin/python3
+#!/usr/bin/env python3
 
-#   Copyright (C) 2024   INAF - Osservatorio Astronomico di Cagliari
+#   Copyright (C) 2025   INAF - Osservatorio Astronomico di Cagliari
 #
 #   This program is free software: you can redistribute it and/or modify
 #   it under the terms of the GNU General Public License as published by

test_data/config_random_example.yml

+# EXAMPLE CONFIGURATION FILE TO BUILD A RANDOM CLUSTER WITH 100 SPHERES.
+
+system_settings:
+  # Limit on host RAM use in Gb (0 for no configuration limit)
+  max_host_ram : 24
+  # Limit on GPU RAM use in Gb (0 for no configuration limit)
+  max_gpu_ram  : 8
+  # Random seed (a positive integer number)
+  rnd_seed     : 105
+  # Random engine (COMPACT or LOOSE)
+  rnd_engine   : "COMPACT"
+  # OBJ model export flag (requires pyvista; 0 is FALSE)
+  make_3D      : 0
+
+input_settings:
+  # Folder to write the code input configuration files
+  input_folder : "."
+  # Name of the scatterer description file
+  spheres_file : "DEDFB_comp"
+  # Name of the geometry description file
+  geometry_file: "DCLU_comp"
+  
+output_settings:
+  # Folder for the code output storage
+  output_folder: "."
+  # Name of the main output file
+  output_name  : "c_OCLU"
+  # Requested output formats
+  formats      : [ "LEGACY", "HDF5" ]
+  # Index of the scale for transition matrix output
+  jwtm         : 1
+
+particle_settings:
+  # What application to use (SPHERE | CLUSTER | INCLUSION)
+  application : "CLUSTER"
+  # Number of spheres
+  n_spheres   : 100
+  # Number of sphere types
+  n_types     : 2
+  # Vector of sphere type identifiers (what type is each sphere)
+  # For random genration it can be empty (random sphere types),
+  # or contain "n_spheres" elements (random position with assigned
+  # types).
+  sph_types   : [ ]
+  # Vector of layers in types (how many layers in each type)
+  n_layers    : [ 1, 1 ]
+  # Spherical monomer radii in m (one size for each type)
+  radii       : [ 4.000e-8, 4.000e-8 ]
+  # Layer fractional radii (one per layer in each type)
+  rad_frac    : [ [ 1.0 ], [ 1.0 ] ]
+  # Index of the dielectric constants (one per layer in each type)
+  #
+  # 1 is first file in `dielec_file`, 2 is second ...
+  dielec_id   : [ [ 1 ], [ 1 ] ]
+  # Maximum radius for random particle size in m
+  max_rad     : 3.0e-7
+
+material_settings:
+  # Dielectric properties definition (-1 = scaled, 0 = tabulated)
+  diel_flag   : 0
+  # External medium dielectric constant
+  extern_diel : 1.00e+00
+  # Dielectric constant files folder
+  dielec_path : "../../ref_data"
+  # List of dielectric constant files (used if diel_flag = 0)
+  dielec_file : [ "eps_ashok_C.csv" ]
+  # Dielectric constant files format (same for all files)
+  dielec_fmt  : [ "CSV" ]
+  # Matching method between optical constants and radiation wavelengths
+  #
+  # INTERPOLATE: the constants are interpolated on wavelengths
+  # GRID: only the wavelengths with defined constants are computed
+  #
+  match_mode  : "GRID"
+  # Reference dielectric constants (used if diel_flag = -1)
+  #
+  # One real and one imaginary part for each layer in each type.
+  diel_const  : [ ]
+
+radiation_settings:
+  # Radiation field polarization (LINEAR | CIRCULAR)
+  polarization: "LINEAR"
+  # First scale to be used
+  scale_start : 1.00e-06
+  # Last scale to be used
+  scale_end   : 2.00e-05
+  # Calculation step (overridden if `match_mode` is GRID)
+  scale_step  : 5.00e-09
+  # Peak Omega
+  wp          : 2.99792e+08
+  # Peak scale
+  xip         : 1.00e+00
+  # Define scale explicitly (0) or in equal steps (1)
+  step_flag   : 0
+  # Type of scaling variable
+  scale_name  : "WAVELENGTH"
+
+geometry_settings:
+  # Maximum internal field expansion
+  li          : 6
+  # Maximum external field expansion (not used by SPHERE)
+  le          : 8
+  # Number of transition layer integration points
+  npnt        : 149
+  # Number of non transition layer integration points
+  npntts      : 300
+  # Averaging mode
+  iavm        : 0
+  # Meridional plane flag
+  isam        : 0
+  # Starting incidence azimuth angle
+  in_th_start : 0.0
+  # Incidence azimuth angle incremental step
+  in_th_step  : 0.0
+  # Ending incidence azimuth angle
+  in_th_end   : 0.0
+  # Starting incidence elevation angle
+  in_ph_start : 0.0
+  # Incidence elevation angle incremental step
+  in_ph_step  : 0.0
+  # Ending incidence elevation angle
+  in_ph_end   : 0.0
+  # Starting scattered azimuth angle
+  sc_th_start : 0.0
+  # Scattered azimuth angle incremental step
+  sc_th_step  : 0.0
+  # Ending scattered azimuth angle
+  sc_th_end   : 0.0
+  # Starting scattered elevation angle
+  sc_ph_start : 0.0
+  # Scattered elevation angle incremental step
+  sc_ph_step  : 0.0
+  # Ending scattered elevation angle
+  sc_ph_end   : 0.0
+  # Vector of sphere X coordinates (one per sphere or empty for random)
+  x_coords    : [ ]
+  # Vector of sphere Y coordinates (one per sphere or empty for random)
+  y_coords    : [ ]
+  # Vector of sphere Z coordinates (one per sphere or empty for random)
+  z_coords    : [ ]