WorldVistA: Difference between revisions
Drew.einhorn (talk | contribs) |
(revert abuse) |
||
(152 intermediate revisions by 8 users not shown) | |||
Line 1: | Line 1: | ||
{{ |
{{WorldVistA}} |
||
== WorldVistA == |
== WorldVistA == |
||
The WorldVistA project is porting the [http://www.worldvista.org WorldVistA] software to the OLPC. |
|||
Typically the backend will run on an XS school server box, |
|||
This is about implementing the WorldVistA software for the OLPC. Most common situation will have the back end running on an XS, with clients running on XO laptops. OLPC is also considering [http://openmrs.org/wiki/OpenMRS OpenMRS] and [http://www.openehr.org/home.html OpenEHR] for this function. I do not know enough about these packages to comment upon them. |
|||
with clients running on XO laptop or nearly any other wireless laptop. |
|||
OLPC is also considering [http://openmrs.org/wiki/OpenMRS OpenMRS] and [http://www.openehr.org/home.html OpenEHR] for this function. |
|||
WorldVistA is a nonprofit formed to extend and collaboratively improve the VistA electronic health record and health information system for use outside of its original setting. The system was originally developed by the U.S. Department of Veterans Affairs (VA) for use in its veterans hospitals, outpatient clinics, and nursing homes. |
WorldVistA is a nonprofit formed to extend and collaboratively improve the VistA electronic health record and health information system for use outside of its original setting. The system was originally developed by the U.S. Department of Veterans Affairs (VA) for use in its veterans hospitals, outpatient clinics, and nursing homes. |
||
Line 11: | Line 14: | ||
the distinction. |
the distinction. |
||
Questions/Comments? |
|||
Need to keep this page at a level appropriate for folks from the library list interested |
|||
Library -> Health -> Software. NEED to move material appropriate for the develop list to |
|||
* Email: [mailto:drew.einhorn@gmail.com drew.einhorn@gmail.com] |
|||
a separate page. |
|||
* Or, just edit the Wiki. |
|||
{{TOCright}} |
|||
Questions/Comments? Email Drew dot Einhorn at gmail dot com. or just edit the Wiki. |
|||
== VistA == |
== VistA == |
||
[[Image:Vista_monograph2005_06_html_34d16251.png|left]] |
|||
VistA is the ('''V'''eterans Health '''I'''nformation '''S'''ystems and '''T'''echnology '''A'''rchitecture) used to run: |
VistA is the ('''V'''eterans Health '''I'''nformation '''S'''ystems and '''T'''echnology '''A'''rchitecture) used to run: |
||
* US Veterans Administration |
* US Veterans Administration hospitals, clinics and nursing homes. |
||
* the Department of Defense, |
* the Department of Defense, |
||
* the Indian Health Service, |
* the Indian Health Service, |
||
Line 27: | Line 32: | ||
* [http://www.hardhats.org/adopters/vista_adopters.html and many, many others] |
* [http://www.hardhats.org/adopters/vista_adopters.html and many, many others] |
||
The source code for VistA was released to the public domain by the US government in response to a FOIA '''F'''reedom '''O'''f '''I'''nformation '''A'''ct request. |
The source code for VistA was released to the public domain by the US government in response to a FOIA '''F'''reedom '''O'''f '''I'''nformation '''A'''ct request. |
||
FOIA source is available [ftp://ftp.va.gov/vista/ Here]. |
|||
A number of commercial, non-profit and government organizations have taken this public domain software and turned it into commercial products, or free and open source software. |
A number of commercial, non-profit and government organizations have taken this public domain software and turned it into commercial products, or free and open source software. |
||
=== VistA Monograph === |
=== VistA Monograph - Primary Sources === |
||
The [http://www.va.gov/vista_monograph/ VistA Monograph] paints a picture of VistA at the Veterans Administration as it was in 2005 and planned for 2006. It is a 146 page detailed description of the capabilities of the VistA system and its component modules. |
The [http://www.va.gov/vista_monograph/ VistA Monograph] paints a picture of VistA at the Veterans Administration as it was in 2005 and planned for 2006. It is a 146 page detailed description of the capabilities of the VistA system and its component modules. |
||
Line 47: | Line 54: | ||
Joseph says this was resolved by negotiation among WorldVistA, the AMA, and the VA. |
Joseph says this was resolved by negotiation among WorldVistA, the AMA, and the VA. |
||
==== VistA Monograph Wiki ==== |
==== [[VistA Monograph Wiki]] ==== |
||
We have just begun the process |
|||
of bringing it up to date. |
of bringing it up to date. |
||
* It's an '''order of magnitude''' over the size limit some '''browsers may choke on it'''. |
* It's an '''order of magnitude''' over the size limit some '''browsers may choke on it'''. |
||
* Need to keep the Table of Contents as is, while splitting it up into files < 32 KB |
* Need to keep the Table of Contents as is, while splitting it up into files < 32 KB |
||
* Need to clean up |
* Need to clean up |
||
* While cleaning up there is a danger on introducing errors |
* While cleaning up there is a danger on introducing errors |
||
Line 60: | Line 68: | ||
* Annotate section if you soon NEED to know whether it is supported. |
* Annotate section if you soon NEED to know whether it is supported. |
||
==== Editing the VistA Monograph Wiki ==== |
|||
===== Just Do It! ===== |
|||
*Take a look at the examples below. |
|||
*When you see an interesting wiki page, click an edit tab or button and see how they did it! |
|||
I started with the .doc file of the VistA Monograph |
|||
*Click an '''edit''' tab or button for the section you wish to update. |
|||
* opened it with Open Office |
|||
*They are close by, maybe on the left, maybe on the right. |
|||
* saved it as html |
|||
*They do move around according to some voodoo I don't completely understand. |
|||
* cleaned it up with Dave Raggett's [http://tidy.sourceforge.net/ HTML Tidy] |
|||
*If they are missing you probably already clicked on an '''edit''' tab or button. |
|||
* converted it to MediaWiki using [http://search.cpan.org/~diberri/HTML-WikiConverter-0.61/lib/HTML/WikiConverter.pm HTML::WikiConverter]. |
|||
* manual editing to clean out a lot of junk html. Need to redo it with a sed script. |
|||
* script to remove excess blank lines. |
|||
It's no wonder it has glitches. I'm surprised it came out as well as it did. |
|||
=== Phillip Longman's book === |
|||
*Scroll down past to formatted wiki page to the edit box. |
|||
[http://www.amazon.com/Best-Care-Anywhere-Health-Better/dp/0977825302 Best Care Anywhere: Why VA Health Care is Better Than Yours] by Phillip Longman provides a history of the development of VistA, its effects on the quality of the health care received by the patients, and the social policy debate on US health care in general. |
|||
*Try to blend into style that surrounds you. |
|||
*The punctuation is important! (At First, You can think of it as Magic Incantations) |
|||
*Hit the '''Show preview''' button |
|||
VistA was created by a collaboration between clinicians and IT folks without senior VA management being aware of what was going on. This resulted in a marvelous system that meets the needs of clinicians. Phillip Longman documents the love/hate relationship between the VA's upper management and the VistA software. |
|||
*Don't worry if you can't get the formatting just right! Just enter plain unformatted text and we will fix it! |
|||
VA Management's view of VistA |
|||
* It's not ours! |
|||
* It's old, ugly, obolete! |
|||
* We've tried to replace it, and failed, failed, ... |
|||
* We win awards for it. |
|||
=== VeHU === |
|||
*Click '''Save page''' |
|||
[http://www.vehu.va.gov/ VeHU], VHA eHealth University training website |
|||
*You will have to answer some simple arithmetic problems to prove you are a human and not a malicious robot! |
|||
===== General MediaWiki Help and How To ===== |
|||
Select All Tracks, no Keywords and browse. |
|||
See: http://wiki.laptop.org/go/Help:Contents Especially the |
|||
[[Help:Wiki_Quicky|Wiki Quickly]] link |
|||
For those who would rather have a more structured approach see: |
|||
The VA removed this valuable site. It is partially back, but it's mostly just stubs. It remains to be seen if it will be fully restored. '''Join the chorus asking the VA to put it back. |
|||
http://wiki.laptop.org/go/Wiki_getting_started#A_more_structured_path |
|||
''' |
|||
=== |
===== WorldVistA Specific Editing ===== |
||
We have developed templates to support a terse description of the status for each VistA component |
|||
First, let's look at some examples as seen by the user. Click on these links. Click the browser "Back" button to come back here. |
|||
[http://www.hardhats.org/ Hardhats] is where the folks running VistA outside the VA hang out. |
|||
#[http://wiki.laptop.org/go/VistA_Monograph_Wiki#Computerized_Patient_Record_System_.28CPRS.29 CPRS] |
|||
There is also a Google Groups based mail list. |
|||
#[http://wiki.laptop.org/go/VistA_Monograph_Wiki#Mental_Health Mental Health] |
|||
#[http://wiki.laptop.org/go/VistA_Monograph_Wiki#VistA_Imaging_System VistA Imaging System] |
|||
Next, consider these excerpts from the wiki code. |
|||
Note: We have not yet settled on a preferred whitespace style in our wiki code. So you will see a variety of styles. A mediawiki bot will probably clean it all up once we make up our mind. |
|||
=== VistA Back End Server === |
|||
===== CPRS Example ===== |
|||
The WorldVistA server running on the XO with a 2GB SD card communicating with CPRS (Computerized Patient Record System) running on Windows laptop. |
|||
<pre><nowiki> |
|||
==== Computerized Patient Record System (CPRS) ==== |
|||
===== Status: CPRS required - Porting to XO not Complete ===== |
|||
*{{WorldVistA-Check}} |
|||
*{{WorldVistA-Porting}} [[Porting Delphi Clients to the XO]] |
|||
*{{WorldVistA-Alt}} [[CPRS Alternative OpenVista CIS]] |
|||
*{{WorldVistA-OLPC-MustHave}} Part of base configuration. |
|||
This Status NEEDs to be propagated to the other CPRS components. |
|||
</nowiki></pre> |
|||
===== Mental Health Example ===== |
|||
[[Image:CPRS.JPG]] |
|||
<pre><nowiki> |
|||
==== Mental Health ==== |
|||
===== Status: Mental Health supported, except ASI-MV missing ===== |
|||
The back end is written in [[Mumps]], we use the open source [http://sourceforge.net/projects/fis-gtm GT.M] implementation. |
|||
*{{WorldVistA-Check}} Mental Health Features supported by WorldVistA, except: |
|||
The WorldVistA server is running on the XO with a 2GB SD card communicating with CPRS (Computerized Patient Record System) running on Windows laptop. |
|||
*{{WorldVistA-Not}} ASI-MV missing from WorldVistA because of copyright issues. |
|||
Perhaps something similar to the agreement with AMA allowing use of the CPT procedure codes can be worked out. |
|||
</nowiki></pre> |
|||
===== VistA Imaging Example ===== |
|||
*Bhaskar said it would be easy. |
|||
<pre><nowiki> |
|||
*Larry Landis installed GT.M, VistA, and got FileMan running. |
|||
==== VistA Imaging System ==== |
|||
*David Whitten put band aids on the rpc broker. |
|||
===== Status: VistA Imaging: missing - Alternate Available ===== |
|||
*{{WorldVistA-Not}}VistA Imaging: missing - Uses proprietary components which are removed by VA from the FOIA release. |
|||
*{{WorldVistA-Alt}}[http://sourceforge.net/projects/o3-dpacs O3 DPACS] IHE compliant from the [http://www.o3consortium.eu/ O3 Consortium] - Open Source - Java based |
|||
</nowiki></pre> |
|||
===== Discuss Examples ===== |
|||
NEED to get Larry to document installation procedure. |
|||
*In each case we begin with the level 4 heading for the subsection describing a VistA component. |
|||
*Immediately after it we insert a level 5 heading, which annotates the Table of Contents with the status of this component under WorldVistA on the XO. |
|||
*Next is a bulleted list that gives us the details. |
|||
**Each bullet begins with a template reference that generates an icon and a status annotation. |
|||
**The template may be followed by a single line of text. |
|||
**Anything longer than that must be moved to page(s) linked to from within the single line of text. |
|||
*Aligning the template reference and text/links in columns enhances readability |
|||
*There may be an optional paragraph that follows the bulleted list. |
|||
===== CPRS Example 2 ===== |
|||
GT.M supports database replication. |
|||
If there is no exceptional status the level 5 status header may be omitted. |
|||
After the CPRS porting is completed we will have: |
|||
<pre><nowiki> |
|||
==== Computerized Patient Record System (CPRS) ==== |
|||
*{{WorldVistA-Check}} |
|||
*{{WorldVistA-Ported}} |
|||
*{{WorldVistA-Alt}} [[CPRS Alternative OpenVista CIS]] |
|||
*{{WorldVistA-OLPC-MustHave}} |
|||
</nowiki></pre> |
|||
=== |
===== Status Templates ===== |
||
{| class="wikitable" |
|||
|- |
|||
! Template |
|||
! Displays as |
|||
! Indicates |
|||
|- |
|||
| [http://wiki.laptop.org/index.php?title=Template:WorldVistA-Check&action=edit <nowiki>{{WorldVistA-Check}}</nowiki>] |
|||
| {{WorldVistA-Check}} |
|||
| Indicates the component is included in the WorldVistA release as described in the monograph. |
|||
|- |
|||
| [http://wiki.laptop.org/index.php?title=Template:WorldVistA-Not&action=edit <nowiki>{{WorldVistA-Not}}</nowiki>] |
|||
| {{WorldVistA-Not}} |
|||
| Indicates the component is NOT included in the WorldVistA release as described in the monograph. |
|||
|- |
|||
| [http://wiki.laptop.org/index.php?title=Template:WorldVistA-Alt&action=edit <nowiki>{{WorldVistA-Alt}}</nowiki>] |
|||
| {{WorldVistA-Alt}} |
|||
| Indicates alternate software that performs the same function. |
|||
|- |
|||
| [http://wiki.laptop.org/index.php?title=Template:Medsphere-Alt&action=edit <nowiki>{{Medsphere-Alt}}</nowiki>] |
|||
| {{Medsphere-Alt}} |
|||
| Alternate software from Medsphere. NEED Medsphere icon/template. Use <nowiki>{{WorldVistA-Alt}}</nowiki> in the meantime. |
|||
|- |
|||
| [http://wiki.laptop.org/index.php?title=Template:O3-Alt&action=edit <nowiki>{{O3-Alt}}</nowiki>] |
|||
| {{O3-Alt}} |
|||
| Alternate software from O3 Consortium. NEED O3 icon/template. Use <nowiki>{{WorldVistA-Alt}}</nowiki> in the meantime. |
|||
|- |
|||
| [http://wiki.laptop.org/index.php?title=Template:WorldVistA-Porting&action=edit <nowiki>{{WorldVistA-Porting}}</nowiki>] |
|||
| {{WorldVistA-Porting}} |
|||
| Indicates WorldVistA is in the process of porting to the XO. |
|||
|- |
|||
| [http://wiki.laptop.org/index.php?title=Template:WorldVistA-Ported&action=edit <nowiki>{{WorldVistA-Ported}}</nowiki>] |
|||
| {{WorldVistA-Ported}} |
|||
| Indicates WorldVistA has completed porting to the XO |
|||
|- |
|||
| [http://wiki.laptop.org/index.php?title=Template:WorldVistA-Addon&action=edit <nowiki>{{WorldVistA-Addon}}</nowiki>] |
|||
| {{WorldVistA-Addon}} |
|||
| additional components. |
|||
|- |
|||
| [http://wiki.laptop.org/index.php?title=Template:WorldVistA-OLPC-MustHave&action=edit <nowiki>{{WorldVistA-OLPC-MustHave}}</nowiki>] |
|||
| {{WorldVistA-OLPC-MustHave}} |
|||
| Required for OLPC |
|||
|- |
|||
| [http://wiki.laptop.org/index.php?title=Template:WorldVistA-OLPC-Want&action=edit <nowiki>{{WorldVistA-OLPC-Want}}</nowiki>] |
|||
| {{WorldVistA-OLPC-Want}} |
|||
| Wanted for OLPC |
|||
|- |
|||
| [http://wiki.laptop.org/index.php?title=Template:WorldVistA-OLPC-DontNeed&action=edit <nowiki>{{WorldVistA-OLPC-DontNeed}}</nowiki>] |
|||
| {{WorldVistA-OLPC-DontNeed}} |
|||
| Not needed for OLPC |
|||
|- |
|||
| [http://wiki.laptop.org/index.php?title=Template:WorldVistA-WHO-MustHave&action=edit <nowiki>{{WorldVistA-WHO-MustHave}}</nowiki>] |
|||
| {{WorldVistA-WHO-MustHave}} |
|||
| Required for WHO |
|||
|- |
|||
| [http://wiki.laptop.org/index.php?title=Template:WorldVistA-WHO-Want&action=edit <nowiki>{{WorldVistA-WHO-Want}}</nowiki>] |
|||
| {{WorldVistA-WHO-Want}} |
|||
| Wanted for WHO |
|||
|- |
|||
| [http://wiki.laptop.org/index.php?title=Template:WorldVistA-WHO-DontNeed&action=edit <nowiki>{{WorldVistA-WHO-DontNeed}}</nowiki>] |
|||
| {{WorldVistA-WHO-DontNeed}} |
|||
| Not needed for WHO |
|||
|} |
|||
===== Other Templates, etc. ===== |
|||
[[Porting Delphi Clients to the XO]] |
|||
==== |
====== <nowiki>{{WorldVistA}}</nowiki> ====== |
||
Generates standard header at top of WorldVistA wiki page. |
|||
====== <nowiki><!-- file --></nowiki> ====== |
|||
The most essential clients are written in [http://www.codegear.com/products/delphi Borland Delphi]. Others are written in Java and other programming languages. |
|||
Indicates where we will split into separate files (pages). Please leave them alone. |
|||
===== Let's Go ===== |
|||
There are several approaches to porting the Delphi code to the XO. |
|||
*First, we need status information at the top of the VistA Monograph entry for each VistA component. |
|||
**WorldVistA folks need to tell us what components are supported by the WorldVistA implementation. And what to do about components that are not supported. |
|||
**OLPC and WHO folks need to tell us what components they need. |
|||
*Next, we need to see how 2005 predictions of the future turned out. See: |
|||
* Running under [http://www.winehq.org Wine]. |
|||
**http://wiki.laptop.org/go/VistA_Monograph_Wiki#HealtheVet-VistA-.28Future.29 |
|||
*Translating Delphi to Python. |
|||
**http://wiki.laptop.org/go/VistA_Monograph_Wiki#On_The_Horizon |
|||
*Translate to [http://www.lazarus.freepascal.org/ Lazarus]/[http://www.freepascal.org Free Pascal]. |
|||
*Translate to server-side AJAX. |
|||
*We need to address any additional 3rd party components. |
|||
Note: None of these options have been tried nor tested on the XO. |
|||
*Then we will be ready to review each section of the VistA Monongraph. |
|||
NEED Test Harness to compare response of old Windows based GUI to new replacement on XO. |
|||
==== Wiki-ing the Vista Monograph ==== |
|||
For notes on how the MS Word .doc was converted to a wiki, See [[Wiki-ing the Vista Monograph]]. |
|||
=== Phillip Longman's book === |
|||
The folks porting to Wine say they are almost there. Don't know when it will actually arrive. Don't know if we have the resources to run software in MS Windows emulation on an XO. Nancy is looking at minimum cpu, memory footprints to support CPRS under wine and on real hardware with windows. |
|||
''Best Care Anywhere: Why VA Health Care is Better Than Yours'', |
|||
by Phillip Longman, |
|||
ISBN 0977825302, |
|||
provides a history of the development of VistA, its effects on the quality of the health care received by the patients, and the social policy debate on US health care in general. |
|||
VistA was created by a collaboration between clinicians and IT folks without senior VA management being aware of what was going on. This resulted in a marvelous system that meets the needs of clinicians. Phillip Longman documents the love/hate relationship between the VA's upper management and the VistA software. |
|||
===== DelPy ===== |
|||
VA Management's view of VistA: |
|||
Our original plan was to create DelPy a Delphi to Python translator. It now looks more likely we will be translating to Lazarus/Free Pascal. |
|||
* It's not ours! |
|||
* It's old, ugly, obsolete! |
|||
* We've tried to replace it, and failed, failed, ... |
|||
* We win awards for it. |
|||
=== VistA Documentation Library === |
|||
We were looking at using [http://www.ssw.uni-linz.ac.at/Research/Projects/Coco/ Coco/R] an open source tool tool which takes an EBNF grammar with attributes and semantic actions and generates a recursive descent parser and lexical anaylyzer. |
|||
[http://www.va.gov/vdl http://www.va.gov/vdl] |
|||
[http://parserbuilder.sourceforge.net/d6grammar.html Here] is a Delphi 6 grammar. It is from a stillborn open source Coco/R project for Delphi. The was a brief flurry of activity in 2002. Nothing has happened since then. There may be copyright/licensing issues since is derived from a BNF grammar published in the Delphi 6 Help file. Stephen is checking his Delphi 6 distribution to see what copyright, license notices are attached. If we use this grammar we will port it to a more modern Coco/R implementation |
|||
=== VeHU - VHA eHealth University === |
|||
[http://www.felix-colibri.com/papers/compilers/delphi_5_grammar/delphi_5_grammar.html Here] is a Delphi 5 grammar derived from the UCSD Pascal grammar. It is a little farther out of date, and will take a bit more work to put it into the Coco/R tools. The copyright/licensing issues may be easier if we start here. |
|||
[http://www.vehu.va.gov/ VeHU], VHA eHealth University training website |
|||
In the unlikely case that we revive the DelPy project we will use [http://pypi.python.org/pypi/CocoPy/ CocoPy] a Coco/R implementation in Python by Ron Longo. |
|||
Select All Tracks, no Keywords and browse. |
|||
===== Compile with Lazarus/Free Pascal ===== |
|||
The VA removed this valuable site. It is partially back, but it's mostly just stubs. It remains to be seen if it will be fully restored. |
|||
Not all components in Borland's VCL ('''V'''isual '''C'''omponent '''L'''ibrary) are available in LCL ('''L'''azarus '''C'''omponent '''L'''ibrary). In particular, LCL is missing '''TFrames''' and '''TRichEdit.''' We will probably discover more gaps that NEED to be filled. We may be able to encourage Larzarus developers to fill thes gaps, or some OLPC developers may have to become Lazarus developers, so we can fill these gaps ourselves. |
|||
'''Join the chorus asking the VA to put it back.''' Email |
|||
[http://wiki.freepascal.org/Lazarus_Components Here] is a chart showing comparing the components available in VCL vs. LCL. We NEED columns indicating components used by VistA front end clients. Don't know how up to date the Delphi and Lazarus columns are. |
|||
[mailto:drew.einhorn@gmail.com drew.einhorn@gmail.com] |
|||
=== Hardhats === |
|||
We may discover issues with the Free Pascal compiler that NEED to be addressed similarly by encouraging or becoming Free Pascal developers. |
|||
[http://www.hardhats.org/ Hardhats] is where the folks running VistA outside the VA hang out. |
|||
It may turn out that we will NEED techniques to translate from one Pascal dialect to another similar to the DelPy translator described above. The D6 grammar gets even closer to where we want to start. Hope we can resolve the D6 Help File license issue. |
|||
There is also a Google Groups based mail list. |
|||
=== VistA Back End Server === |
|||
The WorldVistA server running on the XO with a 2GB SD card communicating with CPRS (Computerized Patient Record System) running on Windows laptop. |
|||
Only a browser is needed |
|||
[[Image:CPRS.JPG|650px]] |
|||
For some time yet, we need to expect that the existing CPRS (written in Delphi) development will continue, perhaps "forever". So this option is aimed at a "moving target" until it overwhelms the existing efforts. |
|||
The back end is written in [[Mumps]], we use the open source [http://sourceforge.net/projects/fis-gtm GT.M] implementation. |
|||
This idea is very young and the needed analysis has not yet been done to see how feasible it is. If most of the CPRS code is dealing with whacking and diddling "window panes", and has very little logic, then this may be an easier way to advance the state of the CPRS access. Unlike the previous options, there would be an abandonment of the existing CPRS code base (ldl: IMO) since having some automated mechanism to separate the "CPRS" from the "diddling" is probably not feasible. |
|||
The WorldVistA server is running on the XO with a 2GB SD card communicating with CPRS (Computerized Patient Record System) running on Windows laptop. |
|||
However (ldl: IMO), once done, the tediousness of maintaining low-level Delphi code is probably overcome by moving the implementation out of "code" and into more of a "specification". (ldl: I doubt that it will ever be an "end user" level activity, but modifying CPRS functionality could and should become a CAC level activity, just like "templates" and other VistA elements). |
|||
*Bhaskar said it would be easy. |
|||
==== The Delphi Clients ==== |
|||
*Larry Landis installed GT.M, VistA, and got FileMan running. |
|||
*David Whitten put band aids on the rpc broker. |
|||
NEED to get Larry to document installation procedure. |
|||
For each client we NEED |
|||
*programming language, |
|||
*number of lines of code, |
|||
*primary source FOIA?, other, |
|||
*supported?, |
|||
**if not alternatives. |
|||
*links to detailed description (VistA Monograph?), |
|||
*documentation |
|||
GT.M supports database replication. |
|||
===== CPRS '''C'''omputerized '''P'''atient '''R'''ecord '''S'''ystem ===== |
|||
=== VistA Front End Clients === |
|||
The [http://wiki.laptop.org/go/VistA_Monograph#Computerized_Patient_Record_System_.28CPRS.29 CPRS] page from the VistA Monograph wiki. |
|||
The [http://www1.va.gov/CPRSdemo/ CPRS Demo] from the Veterans Administration. |
|||
We are starting from Kevin's alpha version with added internationalization, or maybe the CCHIT version, or ... |
|||
===== Mental Health Assistant ===== |
|||
The [http://wiki.laptop.org/go/VistA_Monograph#Mental_Health Mental Health] page from the VistA Monograph wiki. |
|||
What's the difference between version 2 and 3 of Mental Health Assistant? |
|||
===== Query Tool ===== |
|||
===== GUI NOIS ===== |
|||
Stephen says: |
|||
"I wouldn't bother with the GUI NOIS. It was a bug/error/help |
|||
reporting system the VA used. They have moved on to a COTS Remedy." |
|||
ldl says: VistA folks are very interested in "eating our own dog food", and |
|||
since Remedy is "commercial licensed software", and hence cost many dollars... |
|||
Go that way if you want to. NOIS is already running "outside the VA" and |
|||
"global access" tothe implementation outside of the VA is intended. |
|||
===== VistA Imaging ===== |
|||
There are missing pieces of VistA Imaging due to licensing issues. |
|||
[http://sourceforge.net/projects/o3-dpacs O3-DPACS] an open source medical imaging system from the [http://www.o3consortium.eu/ O3 Consortium] based in Italy has been used in VistA Imaging's place. |
|||
===== RPC Broker ===== |
|||
===== FileMan components ===== |
|||
===== BCMA Bar Code Medication Administration ===== |
|||
===== PCMM Primary Care Management Module ===== |
|||
The are several options for [[Porting Delphi Clients to the XO]]. |
|||
===== Vitals ===== |
|||
===== VistA Imaging ===== |
|||
===== Clinical Case Registries ===== |
|||
===== And Others ===== |
|||
Rich V provided most of the above and finished with: |
|||
Notes on porting each [[The Delphi Clients]]. |
|||
"There may be others, but I'm blanking after that list". |
|||
== WorldVistA Software == |
== WorldVistA Software == |
||
Line 234: | Line 315: | ||
WorldVistA runs on the open source [http://sourceforge.net/projects/fis-gtm GT.M] version of [[Mumps]], as well as the proprietary Cache version. |
WorldVistA runs on the open source [http://sourceforge.net/projects/fis-gtm GT.M] version of [[Mumps]], as well as the proprietary Cache version. |
||
Download |
Download WorldVistA Software [http://sourceforge.net/project/showfiles.php?group_id=60087/ here]. |
||
NEED a paragraph or so about each file. |
NEED a paragraph or so about each file. |
Latest revision as of 21:47, 26 December 2012
Porting VistA to the OLPC. For introduction to VistA components see VistA Monograph Wiki.
WorldVistA
The WorldVistA project is porting the WorldVistA software to the OLPC.
Typically the backend will run on an XS school server box, with clients running on XO laptop or nearly any other wireless laptop.
OLPC is also considering OpenMRS and OpenEHR for this function.
WorldVistA is a nonprofit formed to extend and collaboratively improve the VistA electronic health record and health information system for use outside of its original setting. The system was originally developed by the U.S. Department of Veterans Affairs (VA) for use in its veterans hospitals, outpatient clinics, and nursing homes.
Note: there is some confusion between WorldVistA the organization, and the version of the VistA software distributed by WorldVistA. NEED to go through these wiki pages and clarify the distinction.
Questions/Comments?
- Email: drew.einhorn@gmail.com
- Or, just edit the Wiki.
VistA
VistA is the (Veterans Health Information Systems and Technology Architecture) used to run:
- US Veterans Administration hospitals, clinics and nursing homes.
- the Department of Defense,
- the Indian Health Service,
- the government of Mexico,
- and many, many others
The source code for VistA was released to the public domain by the US government in response to a FOIA Freedom Of Information Act request.
FOIA source is available Here.
A number of commercial, non-profit and government organizations have taken this public domain software and turned it into commercial products, or free and open source software.
VistA Monograph - Primary Sources
The VistA Monograph paints a picture of VistA at the Veterans Administration as it was in 2005 and planned for 2006. It is a 146 page detailed description of the capabilities of the VistA system and its component modules.
The Table of Contents and Introduction provides a nice 8 page summary.
Beware
Not every thing you see here is available.
- Some are failed initiatives,
- some use proprietary commercial components that have been redacted from the FOIA release.
- Some are idiosyncratic to the way the VA does business and are not useful outside the VA.
But MOST of it is there and is usable. You can see why we say our goal is Billion Dollar Software on a $200 laptop.
At one time there were issues with licensing of the AMA CPT procedure codes. Joseph says this was resolved by negotiation among WorldVistA, the AMA, and the VA.
VistA Monograph Wiki
We have just begun the process of bringing it up to date.
- It's an order of magnitude over the size limit some browsers may choke on it.
- Need to keep the Table of Contents as is, while splitting it up into files < 32 KB
- Need to clean up
- While cleaning up there is a danger on introducing errors
- compare to the .pdf version
- Need to annotate each section if it is supported in WorldVistA. If not what are the alternatives?
- Annotate section if you soon NEED to know whether it is supported.
Editing the VistA Monograph Wiki
Just Do It!
- Take a look at the examples below.
- When you see an interesting wiki page, click an edit tab or button and see how they did it!
- Click an edit tab or button for the section you wish to update.
- They are close by, maybe on the left, maybe on the right.
- They do move around according to some voodoo I don't completely understand.
- If they are missing you probably already clicked on an edit tab or button.
- Scroll down past to formatted wiki page to the edit box.
- Try to blend into style that surrounds you.
- The punctuation is important! (At First, You can think of it as Magic Incantations)
- Hit the Show preview button
- Don't worry if you can't get the formatting just right! Just enter plain unformatted text and we will fix it!
- Click Save page
- You will have to answer some simple arithmetic problems to prove you are a human and not a malicious robot!
General MediaWiki Help and How To
See: http://wiki.laptop.org/go/Help:Contents Especially the Wiki Quickly link
For those who would rather have a more structured approach see: http://wiki.laptop.org/go/Wiki_getting_started#A_more_structured_path
WorldVistA Specific Editing
We have developed templates to support a terse description of the status for each VistA component
First, let's look at some examples as seen by the user. Click on these links. Click the browser "Back" button to come back here.
Next, consider these excerpts from the wiki code.
Note: We have not yet settled on a preferred whitespace style in our wiki code. So you will see a variety of styles. A mediawiki bot will probably clean it all up once we make up our mind.
CPRS Example
==== Computerized Patient Record System (CPRS) ==== ===== Status: CPRS required - Porting to XO not Complete ===== *{{WorldVistA-Check}} *{{WorldVistA-Porting}} [[Porting Delphi Clients to the XO]] *{{WorldVistA-Alt}} [[CPRS Alternative OpenVista CIS]] *{{WorldVistA-OLPC-MustHave}} Part of base configuration. This Status NEEDs to be propagated to the other CPRS components.
Mental Health Example
==== Mental Health ==== ===== Status: Mental Health supported, except ASI-MV missing ===== *{{WorldVistA-Check}} Mental Health Features supported by WorldVistA, except: *{{WorldVistA-Not}} ASI-MV missing from WorldVistA because of copyright issues. Perhaps something similar to the agreement with AMA allowing use of the CPT procedure codes can be worked out.
VistA Imaging Example
==== VistA Imaging System ==== ===== Status: VistA Imaging: missing - Alternate Available ===== *{{WorldVistA-Not}}VistA Imaging: missing - Uses proprietary components which are removed by VA from the FOIA release. *{{WorldVistA-Alt}}[http://sourceforge.net/projects/o3-dpacs O3 DPACS] IHE compliant from the [http://www.o3consortium.eu/ O3 Consortium] - Open Source - Java based
Discuss Examples
- In each case we begin with the level 4 heading for the subsection describing a VistA component.
- Immediately after it we insert a level 5 heading, which annotates the Table of Contents with the status of this component under WorldVistA on the XO.
- Next is a bulleted list that gives us the details.
- Each bullet begins with a template reference that generates an icon and a status annotation.
- The template may be followed by a single line of text.
- Anything longer than that must be moved to page(s) linked to from within the single line of text.
- Aligning the template reference and text/links in columns enhances readability
- There may be an optional paragraph that follows the bulleted list.
CPRS Example 2
If there is no exceptional status the level 5 status header may be omitted. After the CPRS porting is completed we will have:
==== Computerized Patient Record System (CPRS) ==== *{{WorldVistA-Check}} *{{WorldVistA-Ported}} *{{WorldVistA-Alt}} [[CPRS Alternative OpenVista CIS]] *{{WorldVistA-OLPC-MustHave}}
Status Templates
Template | Displays as | Indicates |
---|---|---|
{{WorldVistA-Check}} | Check | Indicates the component is included in the WorldVistA release as described in the monograph. |
{{WorldVistA-Not}} | Not | Indicates the component is NOT included in the WorldVistA release as described in the monograph. |
{{WorldVistA-Alt}} | Alt | Indicates alternate software that performs the same function. |
{{Medsphere-Alt}} | Template:Medsphere-Alt | Alternate software from Medsphere. NEED Medsphere icon/template. Use {{WorldVistA-Alt}} in the meantime. |
{{O3-Alt}} | Template:O3-Alt | Alternate software from O3 Consortium. NEED O3 icon/template. Use {{WorldVistA-Alt}} in the meantime. |
{{WorldVistA-Porting}} | Porting | Indicates WorldVistA is in the process of porting to the XO. |
{{WorldVistA-Ported}} | Ported | Indicates WorldVistA has completed porting to the XO |
{{WorldVistA-Addon}} | Add on | additional components. |
{{WorldVistA-OLPC-MustHave}} | Must Have | Required for OLPC |
{{WorldVistA-OLPC-Want}} | Want | Wanted for OLPC |
{{WorldVistA-OLPC-DontNeed}} | Don't Need | Not needed for OLPC |
{{WorldVistA-WHO-MustHave}} | Must Have | Required for WHO |
{{WorldVistA-WHO-Want}} | Want | Wanted for WHO |
{{WorldVistA-WHO-DontNeed}} | Don't Need | Not needed for WHO |
Other Templates, etc.
{{WorldVistA}}
Generates standard header at top of WorldVistA wiki page.
<!-- file -->
Indicates where we will split into separate files (pages). Please leave them alone.
Let's Go
- First, we need status information at the top of the VistA Monograph entry for each VistA component.
- WorldVistA folks need to tell us what components are supported by the WorldVistA implementation. And what to do about components that are not supported.
- OLPC and WHO folks need to tell us what components they need.
- Next, we need to see how 2005 predictions of the future turned out. See:
- We need to address any additional 3rd party components.
- Then we will be ready to review each section of the VistA Monongraph.
Wiki-ing the Vista Monograph
For notes on how the MS Word .doc was converted to a wiki, See Wiki-ing the Vista Monograph.
Phillip Longman's book
Best Care Anywhere: Why VA Health Care is Better Than Yours, by Phillip Longman, ISBN 0977825302, provides a history of the development of VistA, its effects on the quality of the health care received by the patients, and the social policy debate on US health care in general.
VistA was created by a collaboration between clinicians and IT folks without senior VA management being aware of what was going on. This resulted in a marvelous system that meets the needs of clinicians. Phillip Longman documents the love/hate relationship between the VA's upper management and the VistA software.
VA Management's view of VistA:
- It's not ours!
- It's old, ugly, obsolete!
- We've tried to replace it, and failed, failed, ...
- We win awards for it.
VistA Documentation Library
VeHU - VHA eHealth University
VeHU, VHA eHealth University training website
Select All Tracks, no Keywords and browse.
The VA removed this valuable site. It is partially back, but it's mostly just stubs. It remains to be seen if it will be fully restored.
Join the chorus asking the VA to put it back. Email drew.einhorn@gmail.com
Hardhats
Hardhats is where the folks running VistA outside the VA hang out. There is also a Google Groups based mail list.
VistA Back End Server
The WorldVistA server running on the XO with a 2GB SD card communicating with CPRS (Computerized Patient Record System) running on Windows laptop.
The back end is written in Mumps, we use the open source GT.M implementation.
The WorldVistA server is running on the XO with a 2GB SD card communicating with CPRS (Computerized Patient Record System) running on Windows laptop.
- Bhaskar said it would be easy.
- Larry Landis installed GT.M, VistA, and got FileMan running.
- David Whitten put band aids on the rpc broker.
NEED to get Larry to document installation procedure.
GT.M supports database replication.
VistA Front End Clients
The are several options for Porting Delphi Clients to the XO.
Notes on porting each The Delphi Clients.
WorldVistA Software
I takes a lot of work to implement a working VistA system. It is possible, many organizations have done it. It's hard to recreate the necessary development environment used by the VA. Portions of the software were redacted because of ownership licensing issues.
WorldVistA has implemented and ditributed a GPL V2 version of the software that works and has obtained CCHIT certification. WorldVistA is debating whether to change the licensing to GPL V3. Most of the source code remains unmodified from the public domain FOIA release. There may be some LGPL in the mix. We probably NEED to have somebody go through all our source (once we get the OLPC Project Hosting Application approved) and check the provenance of each file, adding/checking copyright and license headers as appropriate.
WorldVistA runs on the open source GT.M version of Mumps, as well as the proprietary Cache version.
Download WorldVistA Software here.
NEED a paragraph or so about each file.
Test and Demo Data
We NEED good test and demo data.
Valerie's medical curriculum with sample medical records.
Decision Support System
Emory Fry's Socratic Grid Project is an interesting open source Decision Support System at the recent WorldVistA Community Meeting.
Other folks presented using Clinical Reminders instead. NEED to find link to their presentation.
3rd World Medicine
NEED to understand the differences. Will we need to tweak VistA? Ask Joseph.
Roles
Obviously some roles are performed by many people and some people perform many roles.
Here we are listing the various roles and the skill sets, tools, and tasks associated with each role.
See: OBX and Babel for ideas on icons representing skill sets
Developer - Translators
Developer - Lazarus/Free Pascal
- Analyze WorldVistA client source.
- Identify required components
- TFrames
- TRichEdit
- ...
- patch Free Pascal compile if necessary
- Develop missing LCL components
Sysadmin
Medical information systems must have appropriate levels of administrative support. Backups must be regularly performed. And there must be periodic tests to make sure the recoveries can be performed. We cannot lose a country or region's medical records!!!
Best Practices
The OLPC computers XO and XS will be deployed in large numbers. It simply is not possible to have system administrators monitoring and maintaining each one. The normal administrative process will have to be automated. With reports flowing back to a centralized (Regional) management team. It will be difficult to make sure this scale well and the regional staff is not overwhelmed
A VistA based system requires several types system administrators with different skill sets:
- Unix
- GT.M
- VistA
- CAC (Clinical Application Coordinator)
licensing clerk
Paralegal examines each source file checks provenance, and licenses adds any necessary notices
License Policy
Ponders mysteries like is MSPL an acceptable license for a piece of software we want to use.
Privacy Policy
Approves anonymization of real medical data (with patient permission) for used for
- demonstration
- medical curriculum
- software testing
Note: Privacy laws vary by country. Don't know what rules and regualations would apply to an OLPC based medical records system.
Releasing anonymized medical records can be a bureaucratically intense process with IRBs Institutional Review Boards, etc.
Medical records on the mesh raises interesting privacy problems that need to be addressed.