diff --git a/README.md b/README.md index 879023f091e080adca3f086d833448e9df2c1203..119f40b8dfdc060ebab545ec0a683ab8f62aa8dc 100644 --- a/README.md +++ b/README.md @@ -1,16 +1,24 @@ # OTBTensorflow -This remote module of the [Orfeo ToolBox](https://www.orfeo-toolbox.org) (OTB) aims to provide a deep learning framework targeting remote sensing images processing. +This remote module of the [Orfeo ToolBox](https://www.orfeo-toolbox.org) provides a generic, multi purpose deep learning framework, targeting remote sensing images processing. It contains a set of new process objects that internally invoke [Tensorflow](https://www.tensorflow.org/), and a bunch of user-oriented applications to perform deep learning with real-world remote sensing images. +Applications can be used to build OTB pipelines from Python or C++ APIs. *Main highlights* - Sampling, - Training, supporting save/restore/import operations (a model can be trained from scratch or fine-tuned), - - Serving models with support of OTB streaming mechanism + - Serving models with support of OTB streaming mechanism. Meaning (1) not limited by images sizes, (2) can be used as a "lego" in any OTB pipeline and preserve streaming, (3) MPI support available (use multiple processing unit to generate one single output image) +*Examples* +
+
+ Image translation (pix2pix) +
Transform a Spot-7 image into a Wikimedia Map (pix2pix)
+
+
# How to install -This remote module has been tested successfully on Ubuntu 18 and CentOs 7 with CUDA drivers. +This remote module has been tested successfully on Ubuntu 18 and CentOs 7 with last CUDA drivers. ## Build OTB First, **build the latest *develop* branch of OTB from sources**. You can check the [OTB documentation](https://www.orfeo-toolbox.org/SoftwareGuide/SoftwareGuidech2.html) which details all the steps, if fact it is quite easy thank to the SuperBuild. @@ -150,7 +158,8 @@ cp -r /work/tf/tensorflow/third_party /work/tf/installdir/include cp -r /tmp/proto/include/* /work/tf/installdir/include cp -r /tmp/eigen/include/eigen3/* /work/tf/installdir/include cp /work/tf/tensorflow/tensorflow/contrib/makefile/downloads/nsync/public/* /work/tf/installdir/include/ -find /work/tf/tensorflow/tensorflow/contrib/makefile/downloads/absl/absl/ -name '*.h' -exec cp --parents \{\} /work/tf/installdir/include/ \; +# the goal of the following command line is to put the absl headers in /work/tf/installdir/include/absl and preserving the folders structure +find /work/tf/tensorflow/tensorflow/contrib/makefile/downloads/absl/absl/ -name '*.h' -exec cp --parents \{\} /work/tf/installdir/include/ \; # Cleaning find /work/tf/installdir/ -name "*.cc" -type f -delete @@ -489,7 +498,8 @@ otbcli_TensorflowModelServe -source1.il spot7.tif -source1.placeholder x1 -sourc # Tutorial A complete tutorial is available at [MDL4EO's blog](https://mdl4eo.irstea.fr/2019/01/04/an-introduction-to-deep-learning-on-remote-sensing-images-tutorial/) # Contact -You can contact Rémi Cresson if you have any issues with this remote module at remi [dot] cresson [at] irstea [dot] fr +You can contact R��mi Cresson if you have any issues with this remote module at remi [dot] cresson [at] irstea [dot] fr + diff --git a/doc/landcover.png b/doc/landcover.png new file mode 100644 index 0000000000000000000000000000000000000000..913f3600614420a70adc1bfa8110cdc6e3c3f45a Binary files /dev/null and b/doc/landcover.png differ diff --git a/doc/pix2pix.png b/doc/pix2pix.png new file mode 100644 index 0000000000000000000000000000000000000000..1c79652ff0bae389cbee1c7cde40b2d46f20f089 Binary files /dev/null and b/doc/pix2pix.png differ diff --git a/doc/supresol.png b/doc/supresol.png new file mode 100644 index 0000000000000000000000000000000000000000..efff2fd23176e0fab501ced42aa24c56a2a77a9b Binary files /dev/null and b/doc/supresol.png differ