Browse Database
  Query Database
     - HTML Form
     - Java Web Start
     - XML (Expert)
  Submit Data
     - Java Web Start
     - XML (Expert)
  Data Model
  About this Site
User ID

  BrainML Data Server Documentation

Upload Overview

PDF version

Table of Contents

Choice of Interfaces

The main interface for uploading data to this repository is a Java web start desktop application. In addition, there is an XML interface useful for direct access by software clients.

Java Interface
This implementation, the "Upload Tool", consists of a Java desktop GUI application downloaded and launched on your computer via Java Web Start. To use it you must have Java (runtime) installed. The Upload Tool provides a simple interface for entering your experiment's data and metadata in a format that can be stored and indexed in the neurodatabase.org repository. It will check your submission for completeness and allow you to save your work and resume it later on the same computer. (See system requirements below.)

XML Interface
For developers interested in interfacing directly with the data server in software, we provide an XML interface. Ordinarily (see below), this interface is accessed directly over HTTP by a software client other than a browser. However, for testing purposes, a form is provided in which an XML query can be edited and passed to the server for processing. This is accessed by clicking "XML (Expert)" on the left.

Return to top

Login is Required

In order to upload an experiment to the database you must have an approved account. This can be verified by entering a username and password to a login window once you start the application.

If you have not yet applied for an account, enter your desired username/password in the boxes to the left and press the "Sign Up" button. You will be asked to enter your basic contact information. Your account request will be submitted for approval to the repository's moderator. Once they approve the request you will receive email.

If you have applied for an account over 2 business days ago and have not received a message from a Neurodatabase.org administrator please email us at neurodatabase.AT.med.cornell.edu.

Return to top

Checklist for Submission

Before starting the application to submit your data, you should have:

  • full contact information for the primary contributor, as well as names and institutions of all contributors;
  • full citation information for any literature references to be attached to the submission;
  • identifiers and basic information for all animals/preparations and neurons recorded from;
  • all data to be submitted, either in text format (comma or whitespace-delimited) or in an application such as Excel that is able to provide text data to the clipboard for paste operations.

Click the menu on the left or the links here for more information on the application, or for a description of the data model used.

Return to top

Java Interface Requirements

To run the Java Upload Tool, you will need:

  • Internet Ready Computer with Windows XP/2000 (NT and 98 may work), Linux, or Mac OS X. Solaris and IRIX may work.
  • Java 1.4 or above installed. On the Mac, note that Java comes installed on OS X.
  • Browser with MIME mapping for Web Start helper application enabled. Note this is enabled by default in recent Java installations on Windows and Mac; see this page if you have problems, or if you are running Linux/Unix.

The Upload Tool has been tested on the following systems:

  • Mac OS X, running Java 1.4 or 1.5.
  • Windows XP with IE 6 or Firefox 1.5 running Java 1.4 or 1.5.
  • Linux with Firefox 1.0+ or Galeon and Java 1.4.
It may run on other systems with Java 1.4 or higher and Web Start installed.

Return to top

XML Interface

The XML interface can be accessed through the form as mentioned above, or by direct HTTP POST to URL /query.do under parameter 'xml'. In the latter case, the response will also be in XML.

The XML accepted conforms to the BrainML-X protocols (description, and definition) and the data model describing the submission format. The response (receipt acknowledgement or error report) will also conform to the data model schema.

It is possible to just validate the XML instead of actually submitting it. This is done on the text-box web form by checking the "Validate Only" checkbox. When accessing directly using HTTP POST, you can either use '/validate.do' in place of '/upload.do' or add 'validateOnly=true' to the query string.

Return to top


The BrainML Data Server and Client tools Version 3.0 were developed using Java tools by Sun Microsystems, the Apache-Jakarta Project, and others.


Original design: Michael Abato, Daniel Gardner
Server Support: Kevin Knuth
Development version 1: Robert DeBellis, Thomas White, Youping Xiao
Development, version 2: Ajit Jagdale, David Markowitz, Adrian Robert
Development, version 3: Eliza Chan, Ajit Jagdale, Adrian Robert

© 2001-2008 Weill Medical College of Cornell University

Additional tools are being developed in collaboration with Bruxton Corporation.

Return to top


(Customize in messages.properties)