No Description

bradfordcondon fdadccca68 WIP 6 years ago
.github adb64b24d6 Close opened brackets. 6 years ago
docs e320ae195d Merge pull request #678 from tripal/649-tv3-add_unpublish_functionality 6 years ago
legacy d4c221ea11 rename all modules to 7.x-3.x0 6 years ago
tests 952adb7850 remove remote obo test 6 years ago
tripal b8b8fcf6bd Update tripal/api/tripal.entities.api.inc 6 years ago
tripal_bulk_loader d4c221ea11 rename all modules to 7.x-3.x0 6 years ago
tripal_chado fdadccca68 WIP 6 years ago
tripal_chado_views a7987a7df0 Merge pull request #737 from tripal/712_fix_views_path 6 years ago
tripal_daemon 605d56594d Daemon blocks: fix bug #338 6 years ago
tripal_ds d4c221ea11 rename all modules to 7.x-3.x0 6 years ago
tripal_ws eb677e9a86 return if field has permissions set 6 years ago
.gitignore 9269ca5151 init rtd 6 years ago
.travis.yml 6cbbe78d16 Remove 7.2 6 years ago
CONTRIBUTING.md edee49b436 first draft complete 6 years ago
LICENSE.txt ad615a7bd5 Create LICENSE.txt 7 years ago
README.md 2f2ae83f0f Update README.md 6 years ago
composer.json 3a5c41b8f2 Update tripal test suite, add more jobs api tests and use silent function where appropriate 6 years ago
composer.lock cad8662685 Update tripal test suite and fix tests 6 years ago
phpunit.xml ecdc6dddd8 structure tests into suites 6 years ago

README.md

7.x-3.x Build Status Documentation Status

DOI

alt tag

Tripal is a toolkit for constructing online biological (genetics, genomics, breeding, etc.) community databases, and Tripal is a member of the GMOD family of tools. Tripal v3 provides integration with the GMOD Chado database by default.

Genetics, genomics, breeding, and other biological data are increasingly complicated and time-consuming to publish online for others to search, browse and make discoveries with. Tripal provides a framework to reduce the complexity of creating such a site, and provides access to a community of similar groups that share community-standards. The users of Tripal are encouraged to interact to address questions and learn the best practices for sharing, storing, and visualizing complex biological data.

The primary goals of Tripal are to:

  1. Provide a framework for creating sites that allow display, search, and visualization of biological data, including genetics, genomics, and breeding data;
  2. Use community-derived standards and ontologies to facilitate continuity between sites and foster collaboration and sharing;
  3. Provide an out-of-the-box setup for a genomics site to put new genome assemblies and annotations online; and
  4. Provide Application Programming Interfaces (APIs) to support customized displays, look-and-feel, and new functionality.

Features

The following major features are available in Tripal v3.

  • Tripal v3's design is centered around controlled vocabularies and ontologies. This allows for greater integration with the semantic web and will help support data exchange between Tripal sites.
  • RESTful web services. Tripal v3 introduces RESTful web services for Tripal. The resources provided by these web services uses JSON-LD and WC3 Hydra vocabulary to deliver content.
  • Tripal v3 introduces new content pages. In older versions of Tripal all content was provided via Drupal "nodes". Now content is delivered using new content types (e.g. gene, genetic_marker, organism, germplasm, etc.) and the site admin controls which content types are available on the site.
  • Chado support:
    • Tripal v3 represents a major redesign from previous versions. Previously, Chado was the only storage backend supported. Tripal v3 provides by default support for Chado, but also sports a new design that affords integration of other storage backends (including noSQL options).
    • A Chado v1.2 or v1.3 installer
    • Data loaders for ontologies (controlled vocabularies), GFF files, and FASTA files, publications (from PubMed and AGIRCOLA).
    • Generic Bulk Data Loader Modules allows for creation of custom loaders without programming (requires an understanding of Chado).
    • Supports creation of materialized views for faster data queries.

Required Dependencies

  • Drupal:
    • Drupal 7.x
    • Drupal core modules: Search, Path and PHP modules.
    • Drupal contributed modules:
    • Views
    • Entity API
  • PostgreSQL
  • PHP 5.5+
  • UNIX/Linux

Installation

Please follow the instructions in the online Tripal User's Guide for Tripal v2 or Tripal v3.

Upgrade from Tripal v2.x to v3.x

Please follow the Upgrade Instructions in the Tripal v3 User's Guide

Customization

Tripal can be used “as is” but also allows for complete customization. PHP-based template files are provided for all data types to allow for precise customizations as required by the community. A well-developed Tripal API provides a uniform set of variables and functions for accessing any and all data within the Chado database. See the Tripal 3.x Developer's Handbook for additional details.

Development Testing

To run PHP unit tests on your local system, run composer install to install developer-specific requirements. Next, create a .env file in your /Tests/ directory that defines the DRUPAL_ROOT variable, for example

DRUPAL_ROOT=/var/www/html

Then run PHPUnit from your root Tripal directory.

PHPUnit tests will also be run in the Travis CI build.

Read our testing guidelines