Differences between revisions 40 and 75 (spanning 35 versions)
Revision 40 as of 2010-11-22 10:49:23
Size: 2303
Editor: root
Comment:
Revision 75 as of 2013-04-18 06:49:16
Size: 3498
Editor: IanRees
Comment:
Deletions are marked like this. Additions are marked like this.
Line 3: Line 3:
== EMEN2 == = EMEN2 =
Line 7: Line 7:
EMEN2 is an object oriented database and electronic lab notebook. It is designed to store scientific data in a freeform way without limiting the ability to search/mine the results. Unlike a traditional database, where the contents of each record type (table) must be defined by a database administrator and strictly adhered to, each individual record in EMEN2 can have arbitrary additional parameters outside the record definition, and all such parameters remain fully searchable. Please note, this is **not** the related [[EMAN2]] image processing system.
Line 9: Line 9:
Records in the database may be arbitrarily linked to each other, much like the web. Any record may link to an arbitrary number of other records of arbitrary type (the record's children). Many other records may link to each record (the record's parents). This permits, for example, a publication to be linked into a publications folder as well as being linked to a specific project; or a microscopy session may be a child of both the biological research project as well as the microscope the data was collected on. Structural and computational biologists frequently work with complex data sets assembled from diverse experimental sources, public resources, and analysis methods. Archiving and mining these data sets with their complicated interrelationships remains a persistent challenge, particularly with “open science” initiatives to make entire workflows, including all raw and intermediate data, available with publications.
Line 11: Line 11:
To address these needs, we have developed EMEN2, an object-oriented scientific database and electronic notebook. EMEN2 uses a flexible schema based on plain text descriptions of experimental protocols. These protocols may be local and describe techniques and data within a single lab group. An EMEN2 installation can itself act as a resource, providing public access to selected protocols and data. While originally developed to serve the needs of the cryo-EM community, we believe EMEN2’s architecture provides an excellent foundation for many other scientific endeavors.

EMEN2 is developed using all open-source technologies. The core database is written in the Python programming language, with BerkeleyDB providing a robust embedded database back-end. The infrastructure is highly modular, permitting new ontologies to be fully implemented using only it’s “Web 2.0” interface. In addition, there is a remote API available for client applications. The included EMDash program is a standalone GUI tool for equipment integration, currently used to upload data transparently from our electron microscopes as it is being collected, as well as integrate with other lab equipment. The EMEN2 server itself can be extended in a similar way by writing custom Python modules, which can expose additional views to the Web interface, or new methods to the API.

You can read about EMEN2 in the manuscript [[http://www.ncbi.nlm.nih.gov/pubmed/23360752|EMEN2: an object oriented database and electronic lab notebook]].

== EMEN2 Mailing List ==

 * [[http://groups.google.com/group/emen2|EMEN2 mailing list]]

Please feel free to join the mailing list and ask questions, submit bug reports, or share results.
Line 16: Line 27:
http://ncmi.bcm.edu/publicdata/db/home/ http://ncmi.bcm.edu/publicdata/
Line 20: Line 31:
== EMEN2 Installation and Configuration ==
Line 21: Line 33:
 * [[http://pypi.python.org/pypi/emen2|EMEN2 download]]
Line 22: Line 35:
== Installation and Configuration ==  * [[EMEN2/Dependencies|Dependencies]]
Line 24: Line 37:
* [[http://ncmi.bcm.edu/ncmi/software/software_details?selected_software=EMEN2|Download]]  * [[EMEN2/Install|Installation]]
Line 26: Line 39:
* [[EMEN2/Dependencies|Dependencies]]  * The [[EMEN2/emen2ctl|EMEN2 control script (emen2ctl)]] and [[EMEN2/Startup|starting the server at boot]]
Line 28: Line 41:
* [[EMEN2/Install|Install]]  * [[EMEN2/Hardware|Planning hardware requirements]]
Line 30: Line 43:
* [[EMEN2/config.yml|Configuration]] == EMEN2 Guides ==
Line 32: Line 45:
* [[EMEN2/User_Guide|User Guide]]  * [[EMEN2/Public_Data_Server|Basic EMEN2 overview]]
 
 * [[EMEN2/Backups|Backups and recovery]]
Line 34: Line 49:
* [[EMEN2/FAQ|FAQ]] == EMEN2 API ==
Line 36: Line 51:
* [[EMEN2/Backups|Maintenance and Backups]]  * [[EMEN2/api|Public API documentation]]
Line 38: Line 53:
 * [[EMEN2/rpc|Remote API access]]
Line 39: Line 55:
 * [[EMEN2/Extensions|Writing EMEN2 extensions]]
Line 40: Line 57:
== EMEN2 Client Documentation == == EMDash: EMEN2 Client documentation ==
Line 42: Line 59:
 * [[http://pypi.python.org/pypi/emdash|EMDash download]]
Line 43: Line 61:
* [[EMEN2/emen2client.py|Command line upload/download client: emen2client.py]]  * [[EMEN2/emdash/Install|EMDash installation]]
Line 45: Line 63:
* [[EMEN2/emdash|EMDash microscope client]]

* [[EMEN2/EMAN2_Integration|EMAN2 Integration]]

* [[EMEN2/Integration|Instrument Integration]]


== Technical Discussions ==


* [[EMEN2/Architecture|EMEN2 Architecture]]

* [[EMEN2/Ontologies|EMEN2 Ontologies]]

* [[EMEN2/Export|Data harvesting and Export]]

* [[EMEN2/API|Public API and Web Services]]
 * [[EMEN2/emdash/Tutorial|EMDash tutorial]]

EMEN2

EMEN2

An extesible, object-oriented electronic lab notebook

Please note, this is **not** the related EMAN2 image processing system.

Structural and computational biologists frequently work with complex data sets assembled from diverse experimental sources, public resources, and analysis methods. Archiving and mining these data sets with their complicated interrelationships remains a persistent challenge, particularly with “open science” initiatives to make entire workflows, including all raw and intermediate data, available with publications.

To address these needs, we have developed EMEN2, an object-oriented scientific database and electronic notebook. EMEN2 uses a flexible schema based on plain text descriptions of experimental protocols. These protocols may be local and describe techniques and data within a single lab group. An EMEN2 installation can itself act as a resource, providing public access to selected protocols and data. While originally developed to serve the needs of the cryo-EM community, we believe EMEN2’s architecture provides an excellent foundation for many other scientific endeavors.

EMEN2 is developed using all open-source technologies. The core database is written in the Python programming language, with BerkeleyDB providing a robust embedded database back-end. The infrastructure is highly modular, permitting new ontologies to be fully implemented using only it’s “Web 2.0” interface. In addition, there is a remote API available for client applications. The included EMDash program is a standalone GUI tool for equipment integration, currently used to upload data transparently from our electron microscopes as it is being collected, as well as integrate with other lab equipment. The EMEN2 server itself can be extended in a similar way by writing custom Python modules, which can expose additional views to the Web interface, or new methods to the API.

You can read about EMEN2 in the manuscript EMEN2: an object oriented database and electronic lab notebook.

EMEN2 Mailing List

Please feel free to join the mailing list and ask questions, submit bug reports, or share results.

EMEN2 Demo

There is a publicly accessible, read-only EMEN2 installation for accessing the NCMI's public datasets:

http://ncmi.bcm.edu/publicdata/

An overview document has been created to introduce new users to the EMEN2 web interface. It includes a number of screenshots.

EMEN2 Installation and Configuration

EMEN2 Guides

EMEN2 API

EMDash: EMEN2 Client documentation

EMEN2 (last edited 2013-04-22 20:02:57 by IanRees)