Docs/improving hpc documentation (#3379)

* fix: adding missing import

* feat: adding plots

* docs: just small adjustment

* feat: adding plot call

* docs: changing background to fit theme.

Author: germa89

doc/changelog.d/3379.documentation.md

@@ -0,0 +1 @@
+Docs/improving hpc documentation

doc/source/examples/extended_examples/hpc/fitness_plot.png

@@ -173,7 +173,7 @@ created to run the simulation:
 
 .. literalinclude:: ml_ga_beam.py
     :language: python
-    :start-at: ga_instance = pygad.GA(
+    :start-at: import pygad
     :end-at: To count the number of generations
 
 
@@ -188,15 +188,28 @@ Once the model is set, use the ``run()`` method to start the simulation:
     :end-at: print(f"Time spent (minutes): {(t1-t0)/60}")
 
 
-Plot convergence
-================
+Plot fitness and genes values
+=============================
+
+You can plot the solution fitness across generations and the evolution of gene
+values using the following code:
 
 .. literalinclude:: ml_ga_beam.py
     :language: python
     :start-at: import os
     :end-at: print(f"Fitness value of the best solution = {solution_fitness}")
 
 
+.. figure:: fitness_plot.png
+
+   Fitness at each generation plot
+
+
+.. figure:: genes.png
+
+   Evolution of genes values
+
+
 Model storage
 ==============
 

doc/source/examples/extended_examples/hpc/genes.png

@@ -199,6 +199,8 @@ def mutation_func(offspring, ga_instance):
     return offspring
 
 
+import pygad
+
 ga_instance = pygad.GA(
     # Main options
     sol_per_pop=sol_per_pop,
@@ -223,6 +225,7 @@ def mutation_func(offspring, ga_instance):
     gene_type=gene_type,
     init_range_low=init_range_low,
     init_range_high=init_range_high,
+    save_solutions=True,
 )
 
 ga_instance.igen = 0  # To count the number of generations
@@ -248,6 +251,8 @@ def mutation_func(offspring, ga_instance):
 
 ga_instance.plot_fitness(label=["Applied force"], save_dir=os.getcwd())
 
+ga_instance.plot_genes(solutions="all")
+
 solution, solution_fitness, solution_idx = ga_instance.best_solution(
     ga_instance.last_generation_fitness
 )

doc/source/examples/extended_examples/hpc/hpc_ml_ga.rst

@@ -614,6 +614,8 @@ Advanced configuration
 
 The following topics provide some advanced ideas for you to
 explore when using PyMAPDL on HPC clusters.
+In this section, these topics are just briefly described so
+you can use online resources such as `SLURM documentation <slurm_docs_>`_.
 
 Advanced job management
 -----------------------