A Standard Form with Barcodes and Custom Entries

From Scribus Wiki
Revision as of 02:06, 11 August 2010 by Gpittman (talk | contribs)
Jump to navigation Jump to search

Having made a script for generating Code 39 barcodes, I wanted to take this one step further, and use that script inside a larger script that creates a form that I use which has barcodes on it.

Here it is:

Standard form.png As you can see, this is something designed for a hospital chart, which was the intended use. When I first began doing this, the idea was to begin to generate my notes for charts using Scribus, so I went about creating a template form with Scribus. Since I wanted to have this blend in with existing notes in the chart, I faithfully measured, created, and edited the basic features of the form so that it would be indistinguishable from the stock forms that the hospital makes itself, except for the fact that I wanted to make the notes in the right hand column with Scribus instead of my variably legible handwriting.

The initial faithful rendering had the lines running all the way across the page. Technically, they're still there, but now covered with a text frame having a white background, so that the Scribus text did not have to compete visually with unnecessary lines.

The information in the upper right hand corner is specific to the patient, even this fictitious one, so the template does not have that. This comes from a script with a series of valueDialogs, after which the text frame is generated and the contents entered, one again to duplicate the hospital's computer-generated forms. After that script ran, then I needed to run Barcode Generator in Scribus, then place the barcode and size it properly.

This is where the Code 39 barcode script came in, since I wanted to create the entire label and barcode with the script.

The final step, the topic of this wiki article, involves taking those parts and now simply generating the entire page from scratch. This required going back to my template, taking down dimensions, positions, font sizes to be able to do all of what you see with a script. As you can see, there are two barcodes, the one on the upper left simply indicating the name of the form, since once a patient is discharged, their paper chart is scanned into the hospital's electronic record, so all of this kind of form ends up in the same section in the record. The patient's barcode in the upper right makes sure that it ends up not only in the right patient's chart but the right admission for that patient.

To avoid repetition, I transformed the barcode creation into a function, makebars which you see near the beginning of the script. I also wanted to make sure that I did not mess up my basic layout while editing the notes frame, so the frame with the heading NEUROLOGY CONSULTATON is generated on a newly created layer, separate from all the other content.

I might add that I'm getting feedback from the nursing staff amazed at how legible my notes are. I've also had other doctors ask me how I did this. With enough interest I may work on the hospital to officially add Scribus to the hospital's desktop computers – I've managed to do this for my own use even though technically I don't have administrative rights to save programs.

Something else I've done in selected situations is to take screengrabs of selected brain scan images, then add them with image frames to the page, when this seems useful. Very easy of course with Scribus.


One change you might consider in your own form script compared with this one is to not exit when a "bad" character is entered for the barcode. For my purposes, I felt that if I did make a mistake, I would just delete the page and start all over.

If you happen to try out this script, notice that the valueDialogs ask for 2 bits of info each, separated by white space.

#!/usr/bin/env python
# consultation.py
# created 2010.08.10

import scribus
import sys
import string

def makebars(relx, rely, height, S, humanread):
    origx = relx
    code = startstop

    for x in S[0:]:
        if x.isdigit():
            xnum = int(x)
            code = code + code39[xnum]
        elif ((ord(x) > 64) and (ord(x) < 91)):   # ord(character) yields the ascii value
	    xnum = ord(x) - 55
	    code = code + code39[xnum]
        elif (ord(x) == 32):                      #  space
            code = code + code39[36]
        elif ((ord(x) == 36) or (ord(x) == 37)):  #  $ and %
            xnum = ord(x) + 1
            code = code + code39[xnum]
        elif ((ord(x) > 44) and (ord(x) < 48)):   #  - . /
            xnum = ord(x) - 6
            code = code + code39[xnum]
        elif (ord(x) == 43):                      #  +
            code = code + code39[42]
        elif (ord(x) == 42):
            code = code + startstop               #  * (adding for completeness)
            scribus.messageBox('OOPS!',S + '\nCode 39 does not encode this character: '+x,scribus.ICON_NONE,button1=scribus.BUTTON_OK)

    code = code + startstop

    for y in code[0:]:
        if y == 'n':
            relx = relx + narrow/2
            d = scribus.createLine(relx,rely,relx,rely + height,) #narrow line
            scribus.setLineWidth(narrow, d)
            scribus.setLineColor(b, d)
            scribus.setFillColor(b, d)
            relx = relx + narrow + narrow/2
        elif y == 'w':
            relx = relx + wide/2
            d = scribus.createLine(relx,rely,relx,rely + height,) #wide line
            scribus.setLineWidth(wide, d)
            scribus.setLineColor(b, d)
            scribus.setFillColor(b, d)
            relx = relx + narrow + wide/2
        elif y == 's':                                      #for wide space
            relx = relx + wide

    if (humanread == 'Yes'):
        t = scribus.createText(origx, rely+height+3, relx - origx, 15)
        scribus.setText(S, t)
        scribus.setFont("DejaVu Sans Book", t)
        scribus.setFontSize(8, t)
        scribus.setTextAlignment(scribus.ALIGN_CENTERED, t)

code39 = ['nnswwn','wnsnnw','nwsnnw','wwsnnn','nnswnw','wnswnn','nwswnn','nnsnww','wnsnwn','nwsnwn']
# I'm using 'n' to denote a narrow line, 'w' for wide line, 's' for wide space
# if a space is not wide then a narrow space is created
# next add the codes for A-Z

startstop = 'nsnwwn'
narrow = 1.0   # narrow line width
wide = 2.2    # wide line width
b="Black"     #line color
ypos = 205.68

if (scribus.newDocument(scribus.PAPER_LETTER,(10,10,10,10),scribus.PORTRAIT,1,scribus.UNIT_POINTS,scribus.PAGE_1,0,1)):
    #first, we'll make the basic layout for the page
    L1 = scribus.createLine(25.51,161.57,578.27,161.57)
    L2 = scribus.createLine(25.51,183.42,578.27,183.42)
    L4 = scribus.createLine(298.64,161.57,298.64,747.43)
    while (ypos<750):
        L3 = scribus.createLine(25.51,ypos,578.27,ypos)
    T1 = scribus.createText(28,96,120,15)
    scribus.setText("SCRIBUS MEDICAL CENTER", T1)
    scribus.setTextAlignment(scribus.ALIGN_LEFT, T1)
    scribus.setFont("DejaVu Sans Book", T1)
    scribus.setFontSize(8, T1)
    T2 = scribus.createText(28,124,148,25)
    scribus.setText("PHYSICIAN'S ORDERS", T2)
    scribus.setTextAlignment(scribus.ALIGN_LEFT, T2)
    scribus.setFont("DejaVu Sans Book", T2)
    scribus.setFontSize(12, T2)
    T3 = scribus.createText(25.22,168.29,272.28,16.71)
    scribus.setText("PHYSICIAN'S ORDERS", T3)
    scribus.setTextAlignment(scribus.ALIGN_CENTERED, T3)
    scribus.setFont("DejaVu Sans Book", T3)
    scribus.setFontSize(11, T3)
    T4 = scribus.createText(297.75,168.29,279.78,16.71)
    scribus.setText("PROGRESS NOTES", T4)
    scribus.setTextAlignment(scribus.ALIGN_CENTERED, T4)
    scribus.setFont("DejaVu Sans Book", T4)
    scribus.setFontSize(11, T4)
    # next we get down to getting info about the particular patient
    names = scribus.valueDialog('Last Name + First Name','Last and first names are\n(Separate with white space only) ')
    name = names.split()
    last_name = string.upper(name[0])
    first_name = string.upper(name[1])
    age_DOB = scribus.valueDialog('Age + DOB','Age and DOB (MM/DD/YYYY) are \n(Separate with white space only)')
    ageDOB = age_DOB.split()
    age = ageDOB[0]
    DOB = ageDOB[1]
    adm_hospnum = scribus.valueDialog('Admit Date + Hospital Number','Admission Date (MM/DD/YYYY) and\n 10-digit Hospital No.\n(Separate with white space only)')
    adm_hosp = adm_hospnum.split()
    adm_Date = adm_hosp[0]
    hosp_number = adm_hosp[1]
    MRN = hosp_number[:-3]

    L = scribus.createText(400, 83, 182, 47)
    scribus.setText(last_name+", "+first_name+"\n"+hosp_number+"          "+adm_Date+"\n"+DOB+"   "+age+"Y     "+MRN, L)
    scribus.setTextAlignment(scribus.ALIGN_LEFT, L)
    scribus.setFont("DejaVu Sans Book", L)
    scribus.setFontSize(8, L)
    textLength = len(last_name)+len(first_name)+2
    scribus.setFont("DejaVu Sans Bold",L)
    N = scribus.createText(299.01, 191.3, 280.36, 557.2)
    scribus.setText("NEUROLOGY CONSULTATION", N)
    scribus.setTextAlignment(scribus.ALIGN_LEFT, N)
    scribus.setFont("DejaVu Sans Book", N)
    scribus.setFontSize(11, N)

    scribus.messageBox('OOPS!','Failed to open a new document',scribus.ICON_NONE,button1=scribus.BUTTON_OK)