Difference between revisions of "Getting Started"

From iDigBio
Jump to: navigation, search
m (For Windows)
m
Line 1: Line 1:
 
[[Category:Appliance]][[Category:CYWG]][[Category:Image ingestion]]
 
[[Category:Appliance]][[Category:CYWG]][[Category:Image ingestion]]
 +
 +
== Get the Package and Run on Linux ==
 +
* Download the zip file for windows from [http://www.acis.ufl.edu/~yonggang/idigbio/0.5.1/idigbio-ingestion-tool-master.0.5.1.zip here].
 +
* Unzip the downloaded file "idigbio-ingestion-tool-master.0.5.1.zip" using the tool you have.
 +
* Go into the directory "idigbio-ingestion-tool-master" and double click the file "main.py".
 +
*
 +
<center>[[File:linux_install_1.png | 500px]]</center>
 +
* The idigbio application user interface will be brought up automatically in your default web browser. If not, please input the URL [http://127.0.0.1:32601 127.0.0.1:32601] in your web browser.
 +
<center>[[File:win_install_2.png | 500px]]</center>
  
 
== Get the Package and Run on Windows ==
 
== Get the Package and Run on Windows ==
* Download the zip file for windows from [http://www.acis.ufl.edu/~yonggang/idigbio/0.5.0/idigbio_image_ingestion_tool.0.5.0.win32.zip here (64bit)] or [http://www.acis.ufl.edu/~yonggang/idigbio/0.5.0/idigbio_image_ingestion_tool.0.5.0.win32.32bit.zip here (32bit)].
+
* Download the zip file for windows from [http://www.acis.ufl.edu/~yonggang/idigbio/0.5.1/idigbio_image_ingestion_tool.0.5.1.win32.zip here (Windows Vista and up)] or [http://www.acis.ufl.edu/~yonggang/idigbio/0.5.1/idigbio_image_ingestion_tool.0.5.1.win32.xp.zip here (Windows XP)].
* Unzip the downloaded file "idigbio_image_ingestion_tool_0.5.0_win32.zip" using the tool you have.
+
* Unzip the downloaded file "idigbio_image_ingestion_tool_0.5.1_win32.zip" using the tool you have.
* Double click the file "iDigbio Image Ingestion Tool.exe".
+
* Go into the directory "idigbio_image_ingestion_tool_0.5.1_win32", and double click the file "iDigbio Image Ingestion Tool.exe".
 
<center>[[File:win_install_1.png | 500px]]</center>
 
<center>[[File:win_install_1.png | 500px]]</center>
 
* The idigbio application user interface will be brought up automatically in your default web browser. If not, please input the URL [http://127.0.0.1:32601 127.0.0.1:32601] in your web browser.
 
* The idigbio application user interface will be brought up automatically in your default web browser. If not, please input the URL [http://127.0.0.1:32601 127.0.0.1:32601] in your web browser.

Revision as of 18:02, 26 March 2014


Get the Package and Run on Linux

  • Download the zip file for windows from here.
  • Unzip the downloaded file "idigbio-ingestion-tool-master.0.5.1.zip" using the tool you have.
  • Go into the directory "idigbio-ingestion-tool-master" and double click the file "main.py".
Linux install 1.png
  • The idigbio application user interface will be brought up automatically in your default web browser. If not, please input the URL 127.0.0.1:32601 in your web browser.
Win install 2.png

Get the Package and Run on Windows

  • Download the zip file for windows from here (Windows Vista and up) or here (Windows XP).
  • Unzip the downloaded file "idigbio_image_ingestion_tool_0.5.1_win32.zip" using the tool you have.
  • Go into the directory "idigbio_image_ingestion_tool_0.5.1_win32", and double click the file "iDigbio Image Ingestion Tool.exe".
Win install 1.png
  • The idigbio application user interface will be brought up automatically in your default web browser. If not, please input the URL 127.0.0.1:32601 in your web browser.
Win install 2.png

Signing In with Your Account Information

  • If this is the first time you are using this application, you need to log in with your iDigBio Account UUID and the API Key. You may request the login combination from iDigBio. You can get a account UUID / API key pair by [following this].
  • Fill in your login information in the dialog box after you launch the application, as shown below.
Sign in.png
  • Once you have successfully signed in, your Account UUID and API Key are saved on your computer and you don't need to sign in again next time you open the appliance.

Image Ingestion Tool at a Glance

Main page2.png
  • Upload via CSV : Upload media files using a CSV file.
  • Upload History : View the history of previous uploads from user's computer.
  • Generate CSV : Create a CSV file for the images in a folder.

Image Ingestion Procedures

  1. At first, you want to make a CSV(Comma Separated Value) file. CSV should contain the information about the media files that you are about to upload. We recommend to use the "generate CSV" tab, if you are not aware about a CSV file.
  2. After the CSV file is ready either by manually or by the generation, you can upload media files through "Upload via CSV" tab.
  3. You can always check the previous uploads through the "Upload History" tab.
  • Hereafter, we present an example of uploading bunch of image files from the folder is presented in a step by step manner. It consists of two steps. One is generating a CSV file and then uploading image files with CSV file.

Generate a CSV File

  • At first, click the "generate CSV" tab.
Generate csv 2.png
  • When you type in the path of the folder, it would be easier to copy the path from the address bar.
Generate csv 1.png
  • Then specify the GUID syntax. If you are not aware about the difference among the drop down menu, you can simply use "hash of the record information". Finally, type in the destination path to which the CSV file is stored.
  • A complete list of all fields in the CSV file can be found here: Input CSV Format.

Upload Images using a CSV File

  • Now you upload folder of images through CSV file. At first, specify the image license, then type in the path of CSV file that you created. Finally, click the upload button.
Upload via csv 1.png
  • On successful upload, you should see the result similar to the one shown below.
Success result 1.png

Resuming a Failed Upload Batch

  • If not all the images in the batch are successfully upload, you may see which media is failed to upload.
Falure result 2.png
  • To continue the batch, just click the yellow "Retry failed upload" button. Note that the previously uploaded images are "skipped" (as shown above the progress bar).

Show the History of Previous Uploads

  • When you click on the "Upload History" tab, you will see all the previous upload batches shown like this. Use the "Save CSV for all history" button to save all the history to the specified directory.
History 2.png
  • See the details of each upload batch by clicking on each of entries.
History 3.png

Go Back to Appliance Main Page