Docs update: solvers and parallel multipoint analysis

[kanekosh]

Purpose

• Added a documentation page on the solver to cover the default aerostructural solver, solver recommendations, and a way to change the solvers in runscript
• Changed the linear solver in some examples that uses a large mesh (LinearBlockGS is much faster than the default DirectSolver for these cases)
• Added a documentation page on the parallel multipoint analysis using MPI and ParallelGroup
• Added an MPI multipoint test
• Switched to testflo from pytest to run the MPI test

NOTE: the MPI test does not work with the oldest python/package versions, and I could not fix that. For now, we only run the MPI test on the latest and not on the oldest. This is why the yml looks a little messy.

Expected time until merged

A week

Type of change

• Bugfix (non-breaking change which fixes an issue)
• New feature (non-breaking change which adds functionality)
• Breaking change (non-backwards-compatible fix or feature)
• Code style update (formatting, renaming)
• Refactoring (no functional changes, no API changes)
• Documentation update
• Maintenance update
• Other (please describe)

Testing

I added a new regression test test_multipoint_parallel.

Checklist

• I have run flake8 and black to make sure the Python code adheres to PEP-8 and is consistently formatted
• I have formatted the Fortran code with fprettify or C/C++ code with clang-format as applicable
• I have run unit and regression tests which pass locally with my changes
• I have added new tests that prove my fix is effective or that my feature works
• I have added necessary documentation

[codecov]

Codecov Report

Merging #405 (32a435e) into main (966f8dc) will increase coverage by 0.04%.
The diff coverage is n/a.

@@            Coverage Diff             @@
##             main     #405      +/-   ##
==========================================
+ Coverage   94.47%   94.52%   +0.04%     
==========================================
  Files         103      103              
  Lines        6412     6412              
==========================================
+ Hits         6058     6061       +3     
+ Misses        354      351       -3     

see 2 files with indirect coverage changes

📣 We’re building smart automated test selection to slash your CI/CD build times. Learn more

[eytanadler]

This is great Shugo, thanks so much for adding detailed docs! I learned a lot just by reading these. It looks like a lot of comments, but most are just small grammatical changes.

A separate problem though, do you have any idea what's going on with the build? Something related to the OpenMDAO install seems to be failing. It's definitely not your fault because the same error showed up in the biweekly build that ran recently.

[kanekosh]

@eytanadler Thanks for catching a lot of types and errors!
No idea about the OM installation error, I'll look into the details this week

[eytanadler]

@eytanadler Thanks for catching a lot of types and errors! No idea about the OM installation error, I'll look into the details this week

Sounds good! I'm also not sure what's going on with the RTD build, especially since it worked initially for this PR and you haven't changed anything since.

[eytanadler]

If you don't mind, could you also bump the codecov action to v3 in the github actions file in this PR? Seems like there have been recurring problems recently (but not always), and updating the action might help.