docs: updates to the seeding documentation

[LuisFelipeCoelho]

Some updates to the seeding documentation

[tboldagh]

The document starts with exclaimer that the intro section is outdated. Is it still needed? The intro is fairly general anyways.

[paulgessinger]

The document starts with exclaimer that the intro section is outdated. Is it still needed? The intro is fairly general anyways.

True, with this PR that should probably be removed.

[tboldagh]

Can't comment o unchanged text. But I have simplifying suggestions about captions:
1 - Sketch of the detector with 3 layers. The interaction region is supposed to be located along the z axis and have size significantly smaller than the radius of the innermost detector layer.
2- The x-y projection of the detector with the charged particle helical track originating from the centre of the detector. Signals left by passage of the track through the detector layers are marked with green crosses.
3- The r-z projection of the detector with the same charged particle track. The track is depicted with the same colours as on previous figure.

If you have a chance to touch the plots can they be resized so that on each of them the detector has similar size.
On the figure 3 I would suggest to mark the radius of the detectror as done in 2.

In general the explanations do not belong to the picture captions but should be part of the text.

The explanation of the algorithm starts with phi-z projection. Maybe drawing of such projection could be useful?

[LuisFelipeCoelho]

Thanks a lot @tboldagh for your comments! I will update this ASAP

[LuisFelipeCoelho]

@tboldagh @paulgessinger
I hope that I have addressed all the comments.
I have decided to replace the code block with some equations and further explanation. If you think that I have added too much information or that the pseudo code is still necessary or that I need to add more information, please tell me and I will change it accordingly.

[LuisFelipeCoelho]

not sure why the docs are failing

[paulgessinger]

I think its

/__w/acts/acts/docs/core/seeding.md:190: WARNING: doxygenfunction: Cannot find function "SeedFilter::filterSeeds_2SpFixed" in doxygen xml output for project "Acts" from directory: _build/doxygen-xml
/__w/acts/acts/docs/core/seeding.md:226: WARNING: doxygenfunction: Cannot find function "SeedFilter::filterSeeds_1SpFixed" in doxygen xml output for project "Acts" from directory: _build/doxygen-xml

I'm guessing you need to add the Acts:: namespace before the functions?

[LuisFelipeCoelho]

Thanks a lot @AJPfleger for your comments

[benjaminhuth]

I just read this seeding chapter and found it really good and descriptive, with nice figures, really good work. I think this can go in!

[LuisFelipeCoelho]

Thanks for your revision @benjaminhuth