decimal App Documentation

User Tools

Site Tools

Trace:
planning:userguide:tutorials:courses

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Next revision		Previous revision
planning:userguide:tutorials:courses [2017/01/19 22:23] – created kerhartplanning:userguide:tutorials:courses [2021/07/29 18:28] (current) – external edit 127.0.0.1
Line 1: Line 1:
-====== Courses, Intents, Directives, and Requests ======+====== Courses ======
  
 ==== Overview ==== ==== Overview ====
Line 5: Line 5:
 The Astroid patient data model uses a hierarchy of items to model the real world workflow patterns of the radiotherapy treatment process. Please refer to the **[[planning:instructions_for_use:instructions_for_use#Hierarchy|Heirarchy (Data Model) page]]** if you are not familiar with these concepts. The Astroid patient data model uses a hierarchy of items to model the real world workflow patterns of the radiotherapy treatment process. Please refer to the **[[planning:instructions_for_use:instructions_for_use#Hierarchy|Heirarchy (Data Model) page]]** if you are not familiar with these concepts.
  
-During patient creation (i.e. Importing) a patient record is created containing a //Course//, //Intent//, //Directive//, and //Snapshot//. During Import the required data for the Course, Intent, and Snapshot are entered, however, the Directive remains incomplete. The Directive contains the physician's prescription information including the breakdown of the treatment //Phases// and the specification of //Clinical Goals//. Before creating a //Request// or a //Plan// this information must be entered. Once the Directive is complete, a new request and plan can be created. The following sections provide a walk through for completing the //Directive// and creating a //Request//.+During patient creation (i.e. Importing) a patient record is created containing a //Course// and a //Patient Model//. During Import the required data for the Course and Patient Model are entered, however, the Course remains incomplete. The Course will still require physician directive information including the breakdown of the treatment //Prescriptions// and (optionally) the specification of //Clinical Goals//. Before creating a //Plan// this information must be entered. Once the Prescription is complete, plans can be created. The following sections provide a walk through for completing the //Course// information.
  
-==== Completing the Directive ====+ 
 +Prescriptions are cumulative. For example: when adding a second prescription, it is assumed that the highest dose from the first Rx has already been delivered to the target for the second prescription. Therefore, the total dose to all targets in the second prescription will have the first prescription's highest dose added. 
 +==== Completing the Course Prescription ====
  
   - From the //Patient list//, select a patient to be opened by clicking the patient row   - From the //Patient list//, select a patient to be opened by clicking the patient row
-  - The patient will open to the //patient overview// task and a message will appear telling the user to complete the Directive Phase information {{ :planning:userguide:tutorials:creating_plan_1.png?300 |}}  +  - The patient will open to the //patient overview// task and a message will appear telling the user to complete the Prescription information {{ :planning:userguide:tutorials:creating_plan_1.png?300 |}}  
-  - Before completing the //Directive// you may edit the //Course// or //Intent// by clicking on the appropriate blue //edit// or //open// button beside the desired item (this information is specified by the user while importing the patient, so this is typically unnecessary) {{ :planning:userguide:tutorials:creating_plan_course.png?300 |}} +  - The Prescription information is part of the Course, which can be edited by clicking on the blue //edit// button beside the Course label in the patient overview 
-  - Now open the //Directive// by clicking on the blue //Open// button +   - The //Course// Prescription information is **mandatory** to fill out in order to proceed with planning and at a minimum one Prescription must be created (Clinical Goals are optional) 
-   - The //Directive// information is **mandatory** to fill out in order to proceed with planning and at a minimum a Phase must be created with an appropriate //Prescription// for the case at hand +   - The //Course// contains some basic information as well as two blocks of data: //Clinical Goals// and //Prescriptions// 
-   - The //Directive// information is separated into two blocks of data: //Goals// and //Phases// +   - //Clinical Goals// are used fill in the "goals" (objectives) the physician would like to see achieved by the plan
-   - //Goals// are used fill in the "goals" (objectives) the physician would like to see achieved by the plan+
      - To add a goal, simply select click //Add Structure// and select a desired structure (the choices in the structure drop down will be set by the treatment site template) to which goals should be added      - To add a goal, simply select click //Add Structure// and select a desired structure (the choices in the structure drop down will be set by the treatment site template) to which goals should be added
      - The user can create goals for tumor volumes as well as Organs at Risk (OAR) and can specify minimum dose, maximum dose, mean dose, and volume based (DVH) goal types      - The user can create goals for tumor volumes as well as Organs at Risk (OAR) and can specify minimum dose, maximum dose, mean dose, and volume based (DVH) goal types
-    - The //Goals// will be used for reporting purposes to describe the physician's intent for the treatment; these do not affect the calculation or plan directly {{ :planning:userguide:tutorials:creating_plan_directive_general_2.png?300 |}} +    - The //Clinical Goals// will be used for reporting purposes to describe the physician's intent for the treatment; these do not affect the calculation or plan directly 
-   - The second part of the //Directive// is the //Phases//+   - The second major part of the //Course// are the //Prescriptions//
      - This is where the user will fill in the number of fractions and the prescription dose that specified by the physician      - This is where the user will fill in the number of fractions and the prescription dose that specified by the physician
-     - Note that a phase **must** be created in order to start the planning process +     - Note that a prescription **must** be created in order to start the planning process 
-   - Click //New Phase// under //Phases// to create a new empty phase +   - Click //New Prescription// under //Prescriptions// to create a new empty phase  
-     - The //Phase// label and description are free text fields that the user can enter to help identify a particular phase as needed+     - The //Prescription// label and description are free text fields that the user can enter to help identify a particular phase as needed 
 +       - If the structure chosen is not contained within the patient model a yellow triangle will appear next to the structure chosen alerting the user {{ :planning:userguide:tutorials:rx_error.png?300 |}}
      - A color may be selected for the Phase to aid in identification as well      - A color may be selected for the Phase to aid in identification as well
-     - The number of fractions to be treated should entered and at least one //Prescription// value must be added (the choices available in the structure drop down will be only the targets from the selected treatment site template) {{ :planning:userguide:tutorials:creating_plan_prescription.png?300 |}} +     - The number of fractions to be treated should entered and at least one //Prescription// value must be added (the choices available in the structure drop down will be only the targets from the selected treatment site template)  {{ :planning:userguide:tutorials:creating_plan_prescription.png?300 |}} 
-     - Once all Phase information has been entered, click the blue //Done// button to complete the Phase +     - Once all Prescription information has been entered, click the blue //Add// button to complete the Prescription 
-   - Additional phases may be added at this point if needed (for example, for a treatment needing a base treatment and a boost) +   - Additional prescriptions may be added at this point if needed (for example, for a treatment needing a base treatment and a boost) 
-  - The //Directive// should now be complete +  - The //Course// should now be complete 
-    - Click on the patient's name in the top row (breadcrumbs) to return back to the //Patient Overview// +    - Click on the //Done// button to return back to the //Patient Overview//
- +
-==== Creating a Request ==== +
- +
-  - The //Snapshot// generally does not require editing at this time (see [[planning:userguide:tutorials:snapshots|Snapshots]] for more information) so the user can now proceed on to creating a //Request// +
-  - To add a //Request// click on the blue //Add Request// link underneath the //Snapshot// +
-    - This will create a default //Request// that treats all Fractions for all Phases in the //Directive// +
-    - If this requires modification, then click on the blue //open// button to open the //Request// then click //Edit// to start editing {{ :planning:userguide:tutorials:creating_plan_add_request.png?300 |}} +
-    - Phases may be added, removed, or fraction counts modified using the provided controls (the user can choose whether all fractions [All] are going to be implemented in this phase or if just a certain number [Count]). {{ :planning:userguide:tutorials:creating_plan_phase_fractions.png?300 |}} +
-    - When editing is complete, click the blue //Ok// button at the bottom of the column to save your changes +
-    - Now click on the patient name to go back to the //Patient Overview//+
  
planning/userguide/tutorials/courses.1484864598.txt.gz · Last modified: 2021/07/29 18:24 (external edit)