Clinical Assessment Layout Manager (CALM) Tool


Introduction

This application facilitates preparation on online clinical assessment entry forms and generates Struts JSP and Form bean code for the generic assessment management engine (GAME) in HID web application. Each online clinical assessment consists of multiple pages. Each page consists of an arbitary depth container and display elements hierarchy. A container contains zero or more display components. A display component corresponds to a form field like text entry field, radio button or to styled text. Each container has a layout manager which constraints how its children (other containers and/or display elements) are laid out wrt each other and their parent container.

For installation and other documentation refer to calm.pdf in $CAS_LAYOUT_HOME/doc directory.

Prerequisites

  1. JDK 1.5+ is necessary for CALM which uses Java generics is a major Java language enhancement only available Java 5 (JDK 1.5) or later. The latest JDK available is recommended. (http://java.sun.com/j2se/downloads/)
  2. Apache Ant for build (1.6.x or later) (http://ant.apache.org/)
  3. Make sure your database is setup for CALM

Preliminary Database Setup

Postgres Support
Postgres is the recommended and supported version starting with CALM and HID web app. Use the latest Postgres db generation scripts available via; In Both cases, the instructions are in BIRN/HID/Schema/Postgres/README file

Quick Start Guide

Getting the source code from stratch

You can get the latest CALM from BIRN CVS server via 
cvs checkout BIRN/cas_layout

Build and Configuration

In $CAS_LAYOUTL_HOME, build CALM by running 
$ ant
When you are running ant for the first time you will be asked about database connection parameters. Ant uses that information to create configuration files $CAS_LAYOUT_HOME/conf/caslayout.properties and $CAS_LAYOUT_HOME/conf/log4.properties.

Running CALM

cd to $CAS_LAYOUT_HOME/bin and add execution permission to the script calm.sh and run it like 
calm.sh -help
to see the usage information. Without parameters calm.sh starts the GUI. 
Usage: ${JAVA} caslayout.ui.ClinicalAssessmentLayoutManager [-schema  \
             -xml ] [-help] [-version]
or  ${JAVA} caslayout.ui.ClinicalAssessmentLayoutManager -add -xml 
where
	-help - displays this information
	-schema   -xml  are the CALM XML Schema and the CALM document
	 to be validated against the schema
	-add to add the provided assessment  to the HID database
To validate a CALM document via the provided XML schema (for example) 
calm.sh -schema $CAS_LAYOUT_HOME/conf/calm_document.xsd -xml $CAS_LAYOUT_HOME/examples/sars.xml
To register an assessment with HID database without starting up GUI 
calm.sh -add -xml $CAS_LAYOUT_HOME/examples/sars.xml

Contact Information

For any questions, comments, bug reports contact I. Burak Ozyurt (iozyurt@ucsd.edu)

WHAT'S NEW

---------- 

A list of changes in recent versions

2.1 :(15-Oct-2008)
	- Database registration for an assessment can be done from command 
	line without GUI now.
	- Updated cadebase to use Java generics for better type safety.

2.0 :(11-Oct-2007)
	- Bulk Assessment Data Upload from Excel workbooks.
	- Simplified declarative clinical assessment form layout XML language
	- Automatic online assessment form generation from Excel workbooks.
	
1.7 :(18-Apr-2007)

	- CALM generated forms are fully integrated with HID web app at Struts
	code generation step, fully automating new assessment form additions.