Modified search to take in multiple strings

[medha-14]

Description

Fixes #4629

Type of change

Please add a line in the relevant section of CHANGELOG.md to document the change (include PR #) - note reverse order of PR #s. If necessary, also add to the list of breaking changes.

• New feature (non-breaking change which adds functionality)
• Optimization (back-end change that speeds up the code)
• Bug fix (non-breaking change which fixes an issue)

Key checklist:

• No style issues: $ pre-commit run (or $ nox -s pre-commit) (see CONTRIBUTING.md for how to set this up to run automatically when committing locally, in just two lines of code)
• All tests pass: $ python -m pytest (or $ nox -s tests)
• The documentation builds: $ python -m pytest --doctest-plus src (or $ nox -s doctests)

You can run integration tests, unit tests, and doctests together at once, using $ nox -s quick.

Further checks:

• Code is commented, particularly in hard-to-understand areas
• Tests added that prove fix is effective or that feature works

[medha-14]

I have modified the search method to accept multiple strings. In cases where an exact match is not found, I pass the concatenated string of the multiple inputs to the get_close_matches method.Will this approach suffice for what we are trying to achieve here ?

[codecov]

Codecov Report

Attention: Patch coverage is 88.46154% with 3 lines in your changes missing coverage. Please review.

Project coverage is 99.20%. Comparing base (72c23ea) to head (3f96d73).
Report is 22 commits behind head on develop.

Files with missing lines	Patch %	Lines
src/pybamm/util.py	88.46%	3 Missing ⚠️

Additional details and impacted files

@@             Coverage Diff             @@
##           develop    #4650      +/-   ##
===========================================
- Coverage    99.21%   99.20%   -0.02%     
===========================================
  Files          302      302              
  Lines        22858    22889      +31     
===========================================
+ Hits         22679    22707      +28     
- Misses         179      182       +3     

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

[kratman]

I did not test the code changes locally, but they were just renamings.

Can you add a test with multiple keys in the search? It looks like you only fixed the test for the output formatting

[medha-14]

I have implemented the suggested changes and added tests for searching multiple strings as well.

[brosaplanella]

Looks good to me, just needs an entry to the CHANGELOG before merging

[agriyakhetarpal]

Thanks, @medha-14! Happy to approve/merge after these suggestions.

[agriyakhetarpal]

Actually, in the case of a partial match, would it be better to indicate that it is such? For example,

model.variables.search(["NotAVariable", "concentration"])

now returns

No results for search using '['NotAVariable', 'concentration']'.
Best matches are ['Electrolyte concentration']

but we could say something like

Partial match for key 'concentration' in search using keys '['NotAVariable', 'concentration']'.
Best matches are ['Electrolyte concentration']

because we do have a match here for "concentration", but not for "NotAVariable".

[medha-14]

In cases where some keys have an exact match while others only have a best match, what should the expected result be? Should we only prioritize the exact matches in such cases or should we also have the best matches printed separately?

[agriyakhetarpal]

In cases where some keys have an exact match while others only have a best match, what should the expected result be? Should we only prioritize the exact matches in such cases or should we also have the best matches printed separately?

Do you mean the case where we have an exact match for $m$ keys and a partial/best match for $n - m$ keys? Yes, we should print both the exact matches and the best matches according to the keys. Could you share an example?

If I understood your question correctly, then an input as follows:

model.variables.search(["Electrolyte concentration", "Electrolite concentration"])

should return something, in my opinion, like:

Results matched against 'Electrolyte concentration' in search:
Electrolyte concentration

Partial match for 'Electrolite concentration' in search:
Best matches are ['Electrolyte concentration', 'Electrode potential']

We can figure out the best way to display the output later. There is also a case to be made to say that this improvement to the search functionality to accept multiple strings means that the result is returned for only the string that does return a match, but we are not really implementing a search engine, so I feel it is acceptable to have all results for all input strings (as if we are looping over them in the search). @brosaplanella, what do you think?

[medha-14]

For now i have modified the method to search for exact matches having all the search_keys if no such matches are found it gives search results for each term individually.

model.variables.search(["electrolyte", "concentration"])

Since both terms are present together in a single key, the result will be:

 Results for 'Electrolyte concentration': ['Electrolyte concentration']

For the cases where there are no such matches it will iterate over each string individually and give results as such:

model.variables.search(["RandomKey", "elecrtolyte concentration","electrolite"])

will give results as:

No matches found for 'RandomKey'.
Exact matches for 'electrolyte concentration': ['Electrolyte concentration [Molar]', 'Electrolyte concentration [mol.m-3]']
No exact matches found for 'electrolite'. Best matches are: ['Electrolyte potential [V]']