Current Build Status
This project mainly aims at providing an easy way to collect clinical phenotypes using a standardized vocabulary, thus allowing for straight-forward cross-referencing with gene and disease databases.
The patient data being managed includes:
- demographic information (name, date of birth, ...)
- family information and history (including pedigree)
- medical history
- prenatal and perinatal history
- measurements (with support for instant computation of percentiles and generation of growth charts)
- clinical symptoms & physical findings, with all phenotypic descriptions being mapped to a standardized vocabulary (the Human Phenotype Ontology (HPO))
- diagnosis (mapped to OMIM)
- genetic variants found in the patient
The application provides a web interface accessible from any device equipped with a web browser and a secure connection to the application server. The complexity and technical codification of standardized phenotyping and disease vocabularies is hidden under the friendly UI, which allows for error-tolerant, predictive search of phenotypic descriptions, and provides instant suggestions of additional phenotypes and diseases matching the current phenotype selection to investigate.
Major tools and resources involved used by this project
- The Human Phenotype Ontology (HPO) - a standardized vocabulary of phenotypic abnormalities encountered in human disease; contains approximately 10,000 terms and is being developed using information from OMIM and the medical literature
- Apache Solr - an enterprise search platform
- XWiki - an enterprise web application development framework
This project uses Apache Maven for the whole lifecycle management. From the project's description:
Apache Maven is a software project management and comprehension tool. Based on the concept of a project object model (POM), Maven can manage a project's build, reporting and documentation from a central piece of information.
In short, Maven handles everything related to building the project: downloading the required dependencies, compiling the Java files, running tests, building the jars or final zips, and even more advanced goals such as performing style checks, creating releases and deploying them to a remote repository. All these steps are configured declaratively with as little custom settings as possible, since the philosophy of maven is "convention over configuration", relying on well-defined best practices and defaults, while allowing custom variations where needed.
Building the entire project is as simple as
mvn install, but first the environment must be set-up:
- Make sure a proper JDK is installed, Java SE 1.8 or higher. Just a JRE isn't enough, since the project requires compilation.
- Install maven by downloading it and following the installation instructions.
- Clone the sources of the project locally, using one of:
git clone git://github.com/phenotips/phenotips.gitif you need a read-only clone
git clone firstname.lastname@example.org:phenotips/phenotips.gitif you also want to commit changes back to the project (and you have the right to do so)
- download an archive of the latest release if you don't want to use version control at all
- It is advisable to increase the amount of memory available to Maven:
export MAVEN_OPTS="-Xmx2g -XX:MaxPermSize=256m"
lsand make sure
mvn installat the command line to build the project
- note that the first build will take a while longer, because all the required dependencies are downloaded, but all the subsequent builds should only take a few minutes
Running a custom built instance
The project is split into several modules, among which
distribution/standalone will result in a fully-working self-contained package ready to run. Running the application is as simple as:
mvn install, as stated above, to get the project built
- go to the directory where the final package is located,
- extract the contents of the
phenotips-standalone-<version>.ziparchive to a location of your choice (outside the
targetdirectory, to ensure it is not overwritten by subsequent builds)
- launch the
start.shon unix-like systems,
- open http://localhost:8080/ in a browser
- this is a completely local version, not connected to any other PhenoTips instance or other software in your institution; a default user is provided, you can log in using User:
You can report issues, make feature requests and watch our progress on our JIRA.
Usage & limitations
PhenoTips and its related tools are distributed under the AGPL version 3 (GNU Affero General Public License), a well known free software/open source license recognized both by the Free Software Foundation and the Open Source Initiative. This means that every change made to the code must also be distributed under AGPL, and any composite works that build on top of PhenoTips must use a compatible license.