Added settings commands to StreamReader

CHANGELOG

@@ -17,6 +17,11 @@ Version 4.5.1 (development)
   script. The overlay appears as a red line connecting the given points. The
   points line format is: number of points, followed by x y z coordinates.
 
+- Added stream options to configure parameters for loading data. The new
+  commands are 'fix_orientations', 'save_coloring', and 'keep_attributes'.
+  These commands must be sent before the 'solution' command to take effect.
+  They can only be issued after parallel streams have been initialized with
+  the 'parallel' command (if used).
 
 Version 4.5 released on Feb 6, 2026
 ===================================

lib/stream_reader.cpp

@@ -19,6 +19,11 @@ using namespace mfem;
 
 enum class Command
 {
+   // Settings
+   FixOrientations,
+   SaveColoring,
+   KeepAttributes,
+   // Solution
    Mesh,
    Solution,
    Quadrature,
@@ -66,6 +71,11 @@ static const StreamCommands commands;
 
 StreamCommands::StreamCommands()
 {
+   // Settings
+   (*this)[Command::FixOrientations]      = {"fix_orientations", false, "<0/off/1/on>", "Turn on/off automatic fixing of orientations for inverted elements."};
+   (*this)[Command::SaveColoring]         = {"save_coloring", false, "<0/off/1/on>", "Turn on/off saving of the mesh coloring generated when loading only a mesh."};
+   (*this)[Command::KeepAttributes]       = {"keep_attributes", false, "<proc/0/off/real/1/on>", "When loading a parallel solution, toggle between processor ranks and the original (real) attributes."};
+   // Solution
    (*this)[Command::Mesh]                 = {"mesh", false, "<mesh>", "Visualize the mesh."};
    (*this)[Command::Solution]             = {"solution", false, "<mesh> <solution>", "Visualize the solution."};
    (*this)[Command::Quadrature]           = {"quadrature", false, "<mesh> <quadrature>", "Visualize the quadrature."};
@@ -120,6 +130,25 @@ int StreamReader::ReadStream(
    data.SetMesh(NULL);
    data.keys.clear();
 
+   string str_cmd = data_type;
+
+   while (true)
+   {
+      int ierr = ReadStreamOne(is, str_cmd);
+      if (ierr) { return ierr; }
+
+      if (data.mesh) { break; }
+
+      // load next command
+      is >> ws >> str_cmd;
+   }
+
+   data.ExtrudeMeshAndSolution();
+   return 0;
+}
+
+int StreamReader::ReadStreamOne(istream &is, const string &data_type)
+{
    auto it = find(commands.begin(), commands.end(), data_type);
    if (it == commands.end())
    {
@@ -131,6 +160,27 @@ int StreamReader::ReadStream(
    Command cmd = (Command)(it - commands.begin());
    switch (cmd)
    {
+      case Command::FixOrientations:
+      {
+         string mode;
+         is >> ws >> mode;
+         data.fix_elem_orient = (mode != "off" && mode != "0");
+      }
+      break;
+      case Command::SaveColoring:
+      {
+         string mode;
+         is >> ws >> mode;
+         data.save_coloring = (mode != "off" && mode != "0");
+      }
+      break;
+      case Command::KeepAttributes:
+      {
+         string mode;
+         is >> ws >> mode;
+         data.keep_attr = (mode != "proc" && mode != "off" && mode != "0");
+      }
+      break;
       case Command::Fem2D:
       {
          Vector sol;
@@ -313,15 +363,14 @@ int StreamReader::ReadStream(
       }
       break;
       case Command::Max: //dummy
-         break;
+         return 1;
    }
 
    if (commands[cmd].keys)
    {
       is >> data.keys;
    }
 
-   data.ExtrudeMeshAndSolution();
    return 0;
 }
 
@@ -333,8 +382,6 @@ int StreamReader::ReadStreams(const StreamCollection &input_streams)
    std::vector<ComplexGridFunction*> cgf_array(nproc);
    std::vector<QuadratureFunction*> qf_array(nproc);
 
-   std::string data_type;
-
    int gf_count = 0;
    int cgf_count = 0;
    int qf_count = 0;
@@ -346,10 +393,45 @@ int StreamReader::ReadStreams(const StreamCollection &input_streams)
 #endif
       istream &isock = *input_streams[p];
       // assuming the "parallel nproc p" part of the stream has been read
-      isock >> ws >> data_type >> ws; // "*_data" / "mesh" / "solution"
+      bool load_data = false;
+      Command cmd;
+      while (!load_data)
+      {
+         std::string data_type;
+         isock >> ws >> data_type;
+
+         auto it = find(commands.begin(), commands.end(), data_type);
+         if (it == commands.end())
+         {
+            cerr << "Unknown data format " << data_type << endl;
+            PrintCommands();
+            return 1;
+         }
+
+         cmd = (Command)(it - commands.begin());
+         switch (cmd)
+         {
+            case Command::FixOrientations:
+            case Command::SaveColoring:
+            case Command::KeepAttributes:
+               // assume the options are the same on all ranks
+               ReadStreamOne(isock, data_type);
+               break;
+            case Command::Mesh:
+            case Command::Solution:
+            case Command::Quadrature:
 #ifdef GLVIS_DEBUG
-      cout << " type " << data_type << " ... " << flush;
+               cout << " type " << data_type << " ... " << flush;
 #endif
+               load_data = true;
+               break;
+            default:
+               cerr << "Command not available in parallel";
+               return 1;
+         }
+      }
+
+      isock >> ws;
       mesh_array[p] = new Mesh(isock, 1, 0, data.fix_elem_orient);
       if (!data.keep_attr)
       {
@@ -364,12 +446,12 @@ int StreamReader::ReadStreams(const StreamCollection &input_streams)
          }
       }
       gf_array[p] = NULL;
-      if (data_type == "quadrature")
+      if (cmd == Command::Quadrature)
       {
          qf_array[p] = new QuadratureFunction(mesh_array[p], isock);
          qf_count++;
       }
-      else if (data_type != "mesh")
+      else if (cmd != Command::Mesh)
       {
          if (CheckStreamIsComplex(isock, true))
          {

lib/stream_reader.hpp

@@ -26,6 +26,8 @@ class StreamReader
 
    static bool CheckStreamIsComplex(std::istream &sol, bool parallel = false);
 
+   int ReadStreamOne(std::istream &is, const std::string &data_type);
+
 public:
 
    StreamReader(DataState &data_): data(data_) { }