# QGIS / OTB integration

**URL:** <https://forum.orfeo-toolbox.org/t/qgis-otb-integration/108>\
**Category:** OTB Development\
**Created:** [February 1, 2019, 8:59am UTC](https://forum.orfeo-toolbox.org/t/qgis-otb-integration/108 "2019-02-01T08:59:03Z")\
**Posts on this page:** 6\
**Page:** 1

<div class="post-metadata">

**Author:** ![yannick](https://forum.orfeo-toolbox.org/user_avatar/forum.orfeo-toolbox.org/yannick/32/24_2.png) [@yannick](https://forum.orfeo-toolbox.org/u/yannick)\
**Post date:** [February 1, 2019, 8:59am UTC](https://forum.orfeo-toolbox.org/t/qgis-otb-integration/108/1 "2019-02-01T08:59:04Z")

</div>

Dear all,

I open this discussion feed because we have more and more users who want to use OTB through QGIS 3.x and I think the situation is not very clear.

Here are some suggestions of what we should do to improve the situation :

- clearly describe which versions of QGIS & OTB can be used together, with the right plugin
  - this could be done in the Cookbook, but the actual page is outdated (the new plugin works with QGIS 3.4)

- write in the Cookbook how to install OTB plugin in QGIS, for the latest versions of QGIS (2.18 LTR, and the new 3.2.\* & 3.4.\* versions)
- distribute a zipfile of the plugin under our website ([packages](https://www.orfeo-toolbox.org/packages/))
  - because I think most of people who want to use OTB through QGIS are not developer and don’t have to clone a git repository to install the plugin

What do you think of this proposal ? Should we open issues on OTB documentation and OTB/QGIS plugin ?

---

<div class="post-metadata">

**Author:** ![rashad.kanavath](https://forum.orfeo-toolbox.org/letter_avatar_proxy/v4/letter/r/aeb1de/32.png) [@rashad.kanavath](https://forum.orfeo-toolbox.org/u/rashad.kanavath)\
**Post date:** [February 5, 2019, 11:55am UTC](https://forum.orfeo-toolbox.org/t/qgis-otb-integration/108/2 "2019-02-05T11:55:45Z")

</div>

I would recommend to keep instructions on installing and configuring QGIS and its plugins out of OTB CookBook. The main reason (as it is evident) is it becomes out-dated very fast due to changing in qgis/otb versions.

You can list [README.md](https://gitlab.orfeo-toolbox.org/orfeotoolbox/qgis-otb-plugin/blob/master/README.md) url and a link to QGIS online docs for installing plugin.

You can also keep screens of processing algorithms and probably a processing modeler with grass and gdal and otb (if found appropriate)

> - distribute a zipfile of the plugin under our website ([packages](https://www.orfeo-toolbox.org/packages/))

Yes, this could be put under [Index of /qgis](http://orfeo-toolbox.org/qgis/).  
There is an existing plugins.xml which can be updated to include otb plugin.

> What do you think of this proposal ? Should we open issues on OTB documentation and OTB/QGIS plugin ?

QGIS have a docs of processing\_algs on their user manual.

> **[27. Processing providers and algorithms — QGIS Documentation documentation](https://docs.qgis.org/testing/en/docs/user_manual/processing_algs/)**
>
> QGIS 3.28 documentation: 27. Processing providers and algorithms

We should try not to encourage duplicate or incomplete docs and thereby confuse users on both projects.

I would recommend to have offline documentation for an otb algorithms. Online docs are not frequently updated and nobody can ever keep them sync in both projects. QGIS processing should be able to render an rst/html **if found** locally or simply point to OTB cookbook homepage.

The rst sources can be generated for every otb install and are one cmake install command away from packages.

Benefits for OTB and QGIS

1. same doc everywhere (CookBook, otbcli, QGIS)
2. No need to track which version of OTB application help to show.

Benefits for QGIS

1. No need to maintain docs each and every processing provider.

Lastly, I don’t recommend against having online docs. Just that in this case, offline doc is more approiate and less confusing.

---

<div class="post-metadata">

**Author:** ![yannick](https://forum.orfeo-toolbox.org/user_avatar/forum.orfeo-toolbox.org/yannick/32/24_2.png) [@yannick](https://forum.orfeo-toolbox.org/u/yannick)\
**Post date:** [February 8, 2019, 2:31pm UTC](https://forum.orfeo-toolbox.org/t/qgis-otb-integration/108/3 "2019-02-08T14:31:06Z")

</div>

Thank you Rashad for your answer.  
I agree that we shall not duplicate documentation, but our new end-users must find quickly the documentation. Maybe we can simplify Cookbook and put a link to the right Readme.MD (or later, to a doc in QGIS ?).

Could you create a zipfile for the plugins (versions 3.2 & 3.4) and put them under [http://orfeo-toolbox.org/qgis/](http://orfeo-toolbox.org/qgis/) ?

Thank you !

---

<div class="post-metadata">

**Author:** ![rashad.kanavath](https://forum.orfeo-toolbox.org/letter_avatar_proxy/v4/letter/r/aeb1de/32.png) [@rashad.kanavath](https://forum.orfeo-toolbox.org/u/rashad.kanavath)\
**Post date:** [February 11, 2019, 8:29am UTC](https://forum.orfeo-toolbox.org/t/qgis-otb-integration/108/4 "2019-02-11T08:29:07Z")

</div>

I will update plugins.xml on [orfeo-toolbox.org/qgis/](http://orfeo-toolbox.org/qgis/)

And the quickest way to get docs is to have them under click of help button without opening a link. right?

---

<div class="post-metadata">

**Author:** ![yannick](https://forum.orfeo-toolbox.org/user_avatar/forum.orfeo-toolbox.org/yannick/32/24_2.png) [@yannick](https://forum.orfeo-toolbox.org/u/yannick)\
**Post date:** [February 11, 2019, 8:59am UTC](https://forum.orfeo-toolbox.org/t/qgis-otb-integration/108/5 "2019-02-11T08:59:47Z")

</div>

> And the quickest way to get docs is to have them under click of help button without opening a link. right?

Yes, I think so.

Thank you for updating plugins.xml

---

<div class="post-metadata">

**Author:** ![rashad.kanavath](https://forum.orfeo-toolbox.org/letter_avatar_proxy/v4/letter/r/aeb1de/32.png) [@rashad.kanavath](https://forum.orfeo-toolbox.org/u/rashad.kanavath)\
**Post date:** [February 14, 2019, 1:37pm UTC](https://forum.orfeo-toolbox.org/t/qgis-otb-integration/108/6 "2019-02-14T13:37:55Z")

</div>

As promised here is the updated visual readme.

> **[README.md · master · Main Repositories / qgis-otb-plugin](https://gitlab.orfeo-toolbox.org/orfeotoolbox/qgis-otb-plugin/blob/master/README.md)**
>
> Orfeo ToolBox

Plugins for 3.2 and 3.4 - 3.8 are uploaded!

Feel free to improve or include this link into cookbook.

I would appreciate if you can test readme and verify installation on windows or osx. This code is same as ongoing pr to qgis. So it is a proirity to find any bugs in this if any…  
Maybe a call for testing on otb-users group is needed.
