add support for 1-D and 3-D images, Logger interface, TBImage Wrapper, Tests, Examples (#24)

* add matrix and list support to log_text

* add support for 1-D images in `log_image`

* add ImageFormat explanation

* add seperate function for image objects

* add more formats
change flow of data
different `image_summary` for image object and AbstractArrays

* add preprocess function for image objects for automatic dispatch

* add TBImage, TBImages wrapper

* add tests
* add support for 3-d images such as mri
* add more tests

* add examples folder

* syntax revision

* change if else to function dispatch `image_summary`

* major revision `log_image` smart use of ImageFormats

* change throw message

Author: Shashikant Kadam

examples/Histograms.jl

@@ -0,0 +1,28 @@
+using TensorBoardLogger #import the TensorBoardLogger package
+using Logging #import Logging package
+
+logger = TBLogger("histogramlogs", tb_append) #create tensorboard logger
+
+################log histogram example:################
+#using logger interface
+with_logger(logger) do
+    for i in 1:100
+        x0 = 0.5+i/30; s0 = 0.5/(i/20);
+        edges = collect(-5:0.1:5)
+        centers = collect(edges[1:end-1] .+0.05)
+        histvals = [exp(-((c-x0)/s0)^2) for c = centers]
+        data_tuple = (edges, histvals)
+        @info "histogram/loggerinterface" autobin=rand(10).+0.1*i manualbin=data_tuple
+    end
+end
+
+#using explicit function interface
+for i in 1:100
+    x0 = 0.5+i/30; s0 = 0.5/(i/20);
+    edges = collect(-5:0.1:5)
+    centers = collect(edges[1:end-1] .+0.05)
+    histvals = [exp(-((c-x0)/s0)^2) for c = centers]
+    data_tuple = (edges, histvals)
+    log_histogram(logger, "histogram/explicitinterface/autobin", rand(10).+0.1*i, step = i) #automatic bins
+    log_histogram(logger, "histogram/explicitinterface/manualbin", data_tuple, step = i) #manual bins
+end

examples/Images.jl

@@ -0,0 +1,38 @@
+using TensorBoardLogger #import the TensorBoardLogger package
+using Logging #import Logging package
+using TestImages
+using Flux: Data
+using Random
+logger = TBLogger("imagelogs", tb_append) #create tensorboard logger
+
+################log images example: mri################
+mri = testimage("mri")
+
+#using logger interface
+with_logger(logger) do
+    @info "image/mri/loggerinterface" mri
+end
+#using explicit function interface
+log_image(logger, "image/mri/explicitinterface", mri, step = 0)
+
+
+################log images example: MNIST data################
+images = shuffle(Data.MNIST.images())[1:5]
+
+#using logger interface
+with_logger(logger) do
+    @info "image/mnist/loggerinterface" images = TBImages(images, HW)
+end
+#using explicit function interface
+log_images(logger, "image/mnist/explicitinterface", images, step = 0)
+
+
+################log images example: random arrays################
+noise = rand(16, 16, 3, 4) #Format is HWCN
+
+#using logger interface
+with_logger(logger) do
+    @info "image/noise/loggerinterface" random = TBImage(noise, HWCN)
+end
+#using explicit function interface
+log_image(logger, "image/noise/explicitinterface", noise, HWCN, step = 0)

examples/Scalars.jl

@@ -0,0 +1,25 @@
+using TensorBoardLogger #import the TensorBoardLogger package
+using Logging #import Logging package
+
+logger = TBLogger("scalarlogs", tb_append) #create tensorboard logger
+
+################log scalars example: y = x²################
+#using logger interface
+with_logger(logger) do
+    for x in 1:20
+        @info "scalar/loggerinterface" y = x*x
+    end
+end
+#using explicit function interface
+for x in 1:20
+    log_value(logger, "scalar/explicitinterface", x*x, step = x)
+end
+
+
+################log scalar example: y = x-xi################
+with_logger(logger) do
+    for x in 1:10
+        z = x-x*im
+        @info "scalar/complex" y = z
+    end
+end