From 049c6b9248ea845dacc2dcc0ec6055b91f234a5f Mon Sep 17 00:00:00 2001
From: Tor-Einar Skog <tor-einar.skog@nibio.no>
Date: Wed, 15 Feb 2023 15:40:37 +0100
Subject: [PATCH] Documentation improvement

---
 README.md                           |  27 ++++++---------------------
 docs/illustrations/vipslogo_512.png | Bin 0 -> 21908 bytes
 2 files changed, 6 insertions(+), 21 deletions(-)
 create mode 100644 docs/illustrations/vipslogo_512.png

diff --git a/README.md b/README.md
index 7f96178..c6da2bb 100644
--- a/README.md
+++ b/README.md
@@ -1,26 +1,11 @@
-# ReferenceModel
-
-## How to find and instantiate this model
-TODO: Must find a way of dynamically importing models
-
-Clues here: https://stackoverflow.com/questions/42401495/how-to-dynamically-import-modules#42402095 
+<img src="docs/illustrations/vipslogo_512.png" alt="VIPS Logo" height="250"/>
 
-``` python
->>> from reference_model import reference_model
->>> from vipscore_common.vips_model import VIPSModel
->>> print(VIPSModel.__subclasses__())
-[<class 'reference_model.reference_model.ReferenceModel'>]
->>> print(VIPSModel.__subclasses__()[0])
-<class 'reference_model.reference_model.ReferenceModel'>
->>> t = VIPSModel.__subclasses__()[0]()
->>> t
-<reference_model.reference_model.ReferenceModel object at 0x7f8fab6dee30>
->>> t.get_model_name()
-'Reference Model'
->>> t.get_model_description()
-"\n        The model is a reference model for developers, showcasing best practices and functionalities of a model.\n        It's a simple day degree model for an imagined pest, and when thresholds are passed, the warning status progresses.\n        "
+# ReferenceModel
+This VIPS model is **an example only, without any actual agronomic value**. It provides examples of how you
+create your own pest prediction model that can be deployed to a [VIPSCore-Python server](https://gitlab.nibio.no/VIPS/VIPSCore-Python) deployment.
 
-```
+## How to deploy this model
+See the [VIPSCore-Python README](https://gitlab.nibio.no/VIPS/VIPSCore-Python#install-vips-models) for how to make it available on that server. 
 
 ## Testing
 The tests are located in the `tests` folder, and we're using [Pytest](https://docs.pytest.org/)
diff --git a/docs/illustrations/vipslogo_512.png b/docs/illustrations/vipslogo_512.png
new file mode 100644
index 0000000000000000000000000000000000000000..f4e416ef1adf3fa60969a5cfb1fd6387ee867ae3
GIT binary patch
literal 21908
zcmeAS@N?(olHy`uVBq!ia0y~yU}6Aa4mJh`hA$OYelakJdR2u)lmsP~D-;yvr)B1(
zDwI?fq$;FVWTr7NRNQ(yD{|749aCNZZ|sU=I>w%0DRH)neeWN;>0eH)3<^3KV)R$z
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

literal 0
HcmV?d00001

-- 
GitLab