Cleaner function names

There are some common functions that I think could have better names. I’m not a huge fan of shortening commonly-used names when slightly longer names would bring a lot more clarity. Pandas does stuff like pd.read_clipboard, for instance, rather than read_clip.

Here is a short, non-comprehensive list of functions that I think could be improved with name changes (though I can go through and expand if we decide this is worth doing):

• utils.to_laplace > to_laplacian
• utils.get_lcc > largest_connected_component (debatable, maybe largest_cc? maybe just lcc would be fine here)
• utils.get_multigraph_union_lcc and utils.get_multigraph_intersect_lcc > multigraph_lcc with a keyword argument for union vs intersect
• utils.cartprod > cartesian_product

[rajpratyush]

Hi All, I would like to work on this issue if this is still open.

[bdpedigo]

With regard to the actual changes that need to be made, all of the functions that @loftusa mentioned are in this file: https://github.com/microsoft/graspologic/blob/dev/graspologic/utils/utils.py. @loftusa any other functions that you think should be changed?

You will need to change:

• the name of the function in the function signature
• the name of the function wherever else it appears in the library
• the name of the function in the corresponding documentation
• the name of the function in any tutorials, if applicable (I don’t think any of these functions get called in the tutorials but I could be wrong). The tutorials live here

I would recommend trying to use some sort of IDE with a variable naming tool (VS code, for instance) because many of those tools can change a function name throughout the entire library for you. If not, then something like find and replace, but again, would have to make sure to check other files in the library.