Command Line Uploader Tutorial
The command line uploader is an easy to you program that transfer images to Cloudpak and runs from the command line. The uploader recognizes all the standard bio-formats. It also allows you to upload non-standard images with the -u option.
Install
For Linux, download the zip file and uncompress it. Optionally add a symbolic link to the folder so the uploader is on your path.
To install the uploader on Windows:
- Download installer for Windows.
- Double click the installer and follow the prompts.
- Double click the new Cloudpak Command Prompt icon on the desktop.
Command Line Tutorial
To start double click the Cloudpak Command Line icon on the Windows desktop. You will see something like this:
Now type "uploader" and you will see the uploader options available plus some other information.
$ uploader
Upload an image to Cloudpak.
Usage:
uploader -e email -p password [-huv] [-r host] [-o folder] [-c ratio] filename
-e email address (required).
-p password (required).
filename: the image's main file (required).
For example, to upload image.tif:
uploader -e me@gmail.com -p password image.tif
-h Use h to see this help message.
-c compression ratio (default is 10.0, 1.0 is lossless).
-o folder - folder is the location to store the result files.
When o is specified, the files are not uploaded and
email and password are not required.
-u Use u to upload the results from a folder of files where
the filename parameter specifies the main file and EVERY FILE
in the main file's folder is uploaded.
-r remote host (default http://service.Cloudpak.com/).
-v Use v to see verbose output for debugging.
The properties file 'uploader.properties' can be used to store variables
you don't want to type every time. The command line variables override these.
The properties file is here:
/home/steve/.Cloudpak/uploader.properties
Current uploader.properties arguments:
Copyright 2010 Cloudpak.
Build date: Nov 16, 2010 at 2:09 PM
For more information visit http://service.Cloudpak.com/uploader/
We will explain all the options later. Let's upload an image.
To upload and image type something like the following.
uploader -e youremail -p yourpassword yourimage
You replace the email and password with your email and password that you use when signing into the Cloudpak website. Replace "yourimage" with the full path to an image on your machine. The uploader supports all the popular bio-formats image types.
Let's upload a small jpeg. Window's 7 comes with sample images we can use. To see the list of jpegs type:
dir "C:\Users\Public\Pictures\Sample Pictures" 07/13/2009 09:32 PM 879,394 Chrysanthemum.jpg 07/13/2009 09:32 PM 845,941 Desert.jpg 07/13/2009 09:32 PM 595,284 Hydrangeas.jpg 07/13/2009 09:32 PM 775,702 Jellyfish.jpg 07/13/2009 09:32 PM 780,831 Koala.jpg 07/13/2009 09:32 PM 561,276 Lighthouse.jpg 07/13/2009 09:32 PM 777,835 Penguins.jpg 07/13/2009 09:32 PM 620,888 Tulips.jpg
Upload Jellyfish.jpg using the following command.
uploader -e youremail -p yourpassword "C:\Users\Public\Pictures\Sample Pictures\Jellyfish.jpg" Converting the image. <=================100%==================> Converted in 4s. Uploading 232KB on Nov 21, 2010 at 5:05 PM. <=================100%==================> 235.5KB/s 0s total time The image was uploaded successfully. The image will show up on the web in a few minutes, depending on the size of the image.
The first progress bar is for the conversion process, converting the image to Cloudpak's upload format. The second progress bar is for uploading the image pieces to Cloudpak over the internet. That's it, the image is now in the clouds. Sign in to Cloudpak and you should see the new image in a few moments.