[petsc-dev] Tutorials Question

[Patrick Sanan]

We could include the ones that are somewhat complete at
petsc.org/release/tutorials, but in addition to general cleanup to ensure
they're clear enough to help more than hinder, I think it's essential to
replace the hard-coded code examples with excerpts from the tutorial
programs themselves, and to replace hard-coded output with test reference
output (and ideally do the same for the input so that also can't get out of
sync, but I don't know if we have a clean way to do that from what's in the
/* TEST */ blocks).




Am Sa., 19. Feb. 2022 um 02:14 Uhr schrieb Jacob Faibussowitsch <
jacob.fai at gmail.com>:

> They would need to be cleaned up (many of them tell people to “cd
> $PETSC_DIR/$PETSC_ARCH/src/ksp/ksp/examples/tutorials”), but yeah they
> are a pretty useful on-ramp.
>
> It would also be cool if they followed some structured path, where the
> Vec->Mat->PC/KSP->SNES/DM/TS progression illustrated some evolution of
> abstraction for a single particular problem. Start from finite difference
> and build up to FEM maybe? Not sure.
>
> On Feb 18, 2022, at 18:58, Matthew Knepley <knepley at gmail.com> wrote:
>
> Should we put those back up?
>
>   Thanks,
>
>     Matt
>
> On Fri, Feb 18, 2022 at 7:34 PM Jacob Faibussowitsch <jacob.fai at gmail.com>
> wrote:
>
>> That was an early version of the new docs. Patrick, Hannah, Hong and I
>> wrote those tutorials as we were testing out the new format. The QuickStart
>> tutorial made it into the final set pretty much unchanged, but not sure if
>> the rest of the sections did.
>>
>> On Feb 18, 2022, at 15:23, Matthew Knepley <knepley at gmail.com> wrote:
>>
>> How did these?
>>
>>
>> https://wg-beginners.readthedocs.io/en/latest/tutorials/introductory_tutorial.html
>>
>> They are not on the new site, and people here liked them.
>>
>>    Thanks,
>>
>>       Matt
>>
>> --
>> What most experimenters take for granted before they begin their
>> experiments is infinitely more interesting than any results to which their
>> experiments lead.
>> -- Norbert Wiener
>>
>> https://www.cse.buffalo.edu/~knepley/
>> <http://www.cse.buffalo.edu/~knepley/>
>>
>>
>>
>
> --
> What most experimenters take for granted before they begin their
> experiments is infinitely more interesting than any results to which their
> experiments lead.
> -- Norbert Wiener
>
> https://www.cse.buffalo.edu/~knepley/
> <http://www.cse.buffalo.edu/~knepley/>
>
>
>
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.mcs.anl.gov/pipermail/petsc-dev/attachments/20220219/4c8811ec/attachment.html>