Generalized search_mesh that takes a functor to execute at element boundary or destination

[Fuad-HH]

This new particle_search method allows passing a functor that takes all the necessary objects it wants to handle. It is run every time the particle reaches an element boundary or its destination i.e. after every call of find_exit_face. It will allow various things including handling different boundary conditions, recording information, etc.

[cwsmith]

Thank you. Does this support 2d and/or 3d meshes? Are there any tests available?

[Fuad-HH]

Yes, as the original search_mesh function, it supports both 2D and 3D. Actually, this is exactly the original search_mesh method except what it did when particles reach element boundaries is encapsulated in the functor that is passed in the new particle_search method. There are two test cases (search_adj_2d and search_adj_3d) that use the search_mesh method for 2D and 3D searches. It tests the search_mesh method and it is passing.

[jacobmerson]

@Fuad-HH is #128 ready as well? That has the unit tests you put in place for all of the component functions of search_mesh correct?

[jacobmerson]

Thanks for putting this together. There are a few minor issues that need to be resolved to clean up the interfaces so we are not requiring implementation specific data to be passed around, but this is looking very good.

Thanks!

[Fuad-HH]

I have added a brief description for renamed trace_particle_through_mesh. Does the description look good?

[Fuad-HH]

There shouldn't be any merge conflict, but it's showing an "empty" line coming from master.

[cwsmith]

Looks good. Thank you.