Cloudpak

Limitless Imaging Solutions

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:

Cloudpak Command Prompt

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.

Apycom jQuery Menus