15.2.352. camcops_server.tasks.cia

camcops_server/tasks/cia.py

Copyright (C) 2012, University of Cambridge, Department of Psychiatry. Created by Rudolf Cardinal (rnc1001@cam.ac.uk).

This file is part of CamCOPS.

CamCOPS is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

CamCOPS is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with CamCOPS. If not, see <https://www.gnu.org/licenses/>.

The Clinical Impairment Assessment questionnaire (CIA) task.

class camcops_server.tasks.cia.Cia(**kwargs)[source]
__init__(**kwargs)

A simple constructor that allows initialization from kwargs.

Sets attributes on the constructed instance using the names and values in kwargs.

Only keys that are present as attributes of the instance’s class are allowed. These could be, for example, any mapped columns or relationships.

editing_time_s

How long has the user spent editing the task? (Calculated by the CamCOPS client.)

firstexit_is_abort

Was the first exit from the task’s editor an “abort”?

firstexit_is_finish

Was the first exit from the task’s editor a successful “finish”?

get_task_html(req: camcops_server.cc_modules.cc_request.CamcopsRequest) → str[source]

HTML for the main task content.

Must be overridden by derived classes.

get_trackers(req: camcops_server.cc_modules.cc_request.CamcopsRequest) → List[camcops_server.cc_modules.cc_trackerhelpers.TrackerInfo][source]

Tasks that provide quantitative information for tracking over time should override this and return a list of camcops_server.cc_modules.cc_trackerhelpers.TrackerInfo objects, one per tracker.

The information is read by camcops_server.cc_modules.cc_tracker.Tracker.get_all_plots_for_one_task_html().

Time information will be retrieved using get_creation_datetime().

global_score() → Optional[float][source]

The original paper states:

“To obtain the global CIA impairment score the ratings on all items are added together with prorating of missing ratings, so long as at least 12 of the 16 items have been rated.”

In our implementation all questions are mandatory except for 3, 4, 7 and 10. So there won’t be fewer than 12 items rated for a complete questionnaire.

id
is_complete() → bool[source]

Is the task instance complete?

Must be overridden.

static longname(req: camcops_server.cc_modules.cc_request.CamcopsRequest) → str[source]

Long name (in the relevant language).

patient

“the patient for this task”.

Note that this refers to the CURRENT version of the patient. If there is an editing chain, older patient versions are not retrieved.

Compare camcops_server.cc_modules.cc_blob.blob_relationship(), which uses the same strategy, as do several other similar functions.

Type

SQLAlchemy relationship

patient_id

SQLAlchemy Column that is a foreign key to the patient table.

special_notes

List-style SQLAlchemy relationship to any SpecialNote objects attached to this class. Skips hidden (quasi-deleted) notes.

when_created

Column representing the task’s creation time.

when_firstexit

Column representing when the user first exited the task’s editor (i.e. first “finish” or first “abort”).

when_last_modified