decimal App Documentation

User Tools

Site Tools

Trace: • results_api • userguide • userguide • results_api_functions
dosimetry:userguide:userguide

Differences

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

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision		Previous revision
dosimetry:userguide:userguide [2015/07/02 15:44] – [thinknode™] dpatenaudedosimetry:userguide:userguide [2021/07/29 18:23] (current) – external edit 127.0.0.1
Line 7: Line 7:
 Access to the astroid Dosimetry App is provided by the thinknode™ framework using http json formatted requests. thinknode™ provides the 'backbone' used to send and receive requests, maintain users, realms and organizations, and provide data storage and management. Access to the astroid Dosimetry App is provided by the thinknode™ framework using http json formatted requests. thinknode™ provides the 'backbone' used to send and receive requests, maintain users, realms and organizations, and provide data storage and management.
  
 +The [[http://docs.apps.dotdecimal.com/dosimetry|Dosimetry Manifest Guide]] contains a complete list of all functions and types supported by the astroid Dosimetry App through API calls.
 ===== Purpose ===== ===== Purpose =====
  
Line 48: Line 49:
 ===== Proton Delivery System Conventions ===== ===== Proton Delivery System Conventions =====
  
-(this section could also be named Geometric and Beamline Conventions)+==== Geometric and Beamline Conventions ==== 
  
 The [[dosimetry:userguide:proton_delivery_system_conventions|Proton Delivery System Conventions]] page details definitions about the following topics: The [[dosimetry:userguide:proton_delivery_system_conventions|Proton Delivery System Conventions]] page details definitions about the following topics:
Line 77: Line 79:
     * [[dosimetry:userguide:design_task_functions:dtf#compute_an_optimized_range_compensator|Compute an Optimized Range Compensator]]      * [[dosimetry:userguide:design_task_functions:dtf#compute_an_optimized_range_compensator|Compute an Optimized Range Compensator]] 
     * [[dosimetry:userguide:design_task_functions:dtf#patch_field_range_compensator|Patch Field Range Compensator]]      * [[dosimetry:userguide:design_task_functions:dtf#patch_field_range_compensator|Patch Field Range Compensator]] 
 +
 +
 +  * **[[dosimetry:userguide:design_task_functions:dtf#pbs_fluence_optimization|PBS Fluence Optimization ]]**: Explanation and sample process for PBS plan optimization functions
 +    * [[dosimetry:userguide:design_task_functions:dtf#optimize_pbs_plan|Compute an Optimized PBS Plan]]
 ==== Dose Calculation Functions ==== ==== Dose Calculation Functions ====
  
-Detailed function and data type definitions can be found at [[http://docs.apps.dotdecimal.com/dosimetry|Dosimetry Manifest Guide]]. Below are basic descriptions and details about the Dose Calculation Functions, dose modeling, and dose construction. +Detailed function and data type definitions can be found at [[http://docs.apps.dotdecimal.com/dosimetry|Dosimetry Manifest Guide]]. Below are basic descriptions of the available dose functions and details about the dose calculation algorithm and dose modeling.
- +
-  * **[[dosimetry:userguide:dose_calculation_functions:dcf#sobp_dose_functions| SOBP Dose Functions]]**  +
-    * [[dosimetry:userguide:dose_calculation_functions:dcf#dose_calculation_modeling|Dose Calculation Modeling]] +
-    * [[dosimetry:userguide:dose_calculation_functions:dcf#construction_and_modeling|Construction and Modeling]]+
  
 +  * [[dosimetry:userguide:dose_calculation_functions:dcf#pbs_dose_functions| PBS Dose Functions]] 
 +  * [[dosimetry:userguide:dose_calculation_functions:dcf#sobp_dose_functions| SOBP Dose Functions]]
 +  * [[dosimetry:userguide:dose_calculation_functions:dcf#dose_calculation_modeling|Dose Calculation & Modeling]]
 ==== Radiotherapy Support Functions ==== ==== Radiotherapy Support Functions ====
  
Line 93: Line 98:
     * [[dosimetry:userguide:radiotherapy_support_functions:rsf#contour_and_structure_modification|Contour and Structure Modification]]     * [[dosimetry:userguide:radiotherapy_support_functions:rsf#contour_and_structure_modification|Contour and Structure Modification]]
     * [[dosimetry:userguide:radiotherapy_support_functions:rsf#degrader_manipulation|Degrader Manipulation]]     * [[dosimetry:userguide:radiotherapy_support_functions:rsf#degrader_manipulation|Degrader Manipulation]]
 +    * [[dosimetry:userguide:radiotherapy_support_functions:rsf#pbs_layers|PBS Energy Layer Determinations]]
  
  
Line 103: Line 109:
   * [[dosimetry:userguide:datatypes#dij_matrix|Dij Matrix]]   * [[dosimetry:userguide:datatypes#dij_matrix|Dij Matrix]]
  
-===== Examples =====+===== Calc Provider Examples =====
  
 ==== thinknode™ ==== ==== thinknode™ ====
  
 Official thinknode™ user guide documentation can be found at [[https://developers.thinknode.com|https://developers.thinknode.com]]. Below are basic examples of communicating with thinknode™ calculation providers. Official thinknode™ user guide documentation can be found at [[https://developers.thinknode.com|https://developers.thinknode.com]]. Below are basic examples of communicating with thinknode™ calculation providers.
- 
-  * **[[dosimetry:userguide:thinknode#c++|C++]]:** Sample C++ project (note: this example requires third party libraries) that details the following thinknode™ api functions: 
-    * [[dosimetry:userguide:thinknode#c++:_immutable_storage|C++: Post to Immutable Storage]] 
-    * [[dosimetry:userguide:thinknode#c++:_calculation_request|C++: Post a Calculation Request]] 
- 
  
   * **[[dosimetry:userguide:thinknode#python|Python]]:** Sample Python project (note: this example requires third party libraries) that details the following thinknode™ api functions:   * **[[dosimetry:userguide:thinknode#python|Python]]:** Sample Python project (note: this example requires third party libraries) that details the following thinknode™ api functions:
     * [[dosimetry:userguide:thinknode#python:_immutable_storage|Python: Post to Immutable Storage]]     * [[dosimetry:userguide:thinknode#python:_immutable_storage|Python: Post to Immutable Storage]]
     * [[dosimetry:userguide:thinknode#python:_calculation_request|Python: Post a Calculation Request]]     * [[dosimetry:userguide:thinknode#python:_calculation_request|Python: Post a Calculation Request]]
- 
-  * **[[dosimetry:userguide:thinknode#node.js|Node.js]]:** Sample node.js scripts 
-    * [[dosimetry:userguide:thinknode#node:_decrypt_base64_blob_data|Node: Decrypt Base 64 Blob Data]] 
  
 ==== DTFs, DCFs, & RSFs ==== ==== DTFs, DCFs, & RSFs ====
  
-Refer to the [[userguide:userguide#function_categories|Function Categories]] section for explanation and usages for each function type.+Refer to the [[dosimetry:userguide:userguide#function_categories|Function Categories]] section for explanation and usages for each function type.
 ===== System Usage =====  ===== System Usage ===== 
  
Line 135: Line 133:
 === Grid and Image Data Interpretation === === Grid and Image Data Interpretation ===
  
-The difference between the grid and image origin definitions can easily result in image or grid data being misinterpreted. Image origins are defined at the top left most corner of the image, while grid origins are defined as the position of the upper-left most point as shown below.+The difference between the grid and image origin definitions can result in image or grid data being misinterpreted. Image origins are defined at the corner of the image, while grid origins are defined directly as the position of the corner point as shown below.
  
 For images, it's important to remember that the location of the pixel value is at the pixel center point, so the position of the first cell, for example, should be shifted by 1/2 of the pixel spacing. Grids however typically contain point data (not cell centered), so data and position correspond directly with a shift. For images, it's important to remember that the location of the pixel value is at the pixel center point, so the position of the first cell, for example, should be shifted by 1/2 of the pixel spacing. Grids however typically contain point data (not cell centered), so data and position correspond directly with a shift.
  
-{{:userguide:grid_image_origin.png?400&nolink|}}+{{dosimetry:userguide:grid_image_origin.png?400&nolink|}}
  
  
Line 150: Line 148:
 It's important to remember there are multiple coordinate systems being used simultaneously for dosimetry planning that are all very dependent on each other.  It's important to remember there are multiple coordinate systems being used simultaneously for dosimetry planning that are all very dependent on each other. 
  
-For a more detailed look at the coordinate systems refer to [[userguide:proton_delivery_system_conventions#coordinate_systems| Proton Delivery System Coordinate Systems]]+For a more detailed look at the coordinate systems refer to [[dosimetry:userguide:proton_delivery_system_conventions#coordinate_systems| Proton Delivery System Coordinate Systems]]
  
 ===== Known Application Limitations ===== ===== Known Application Limitations =====
Line 162: Line 160:
   - **Large array_types of number_types** create issues with uploading to the ISS provider if the points are too dense.   - **Large array_types of number_types** create issues with uploading to the ISS provider if the points are too dense.
     - Consider keeping arrays of numbers from being overly large.     - Consider keeping arrays of numbers from being overly large.
 +  - **PBS Dose Calculation Functions** accept the input type of proton_degrader, which allows for the use of a variable thickness range-compensator.
 +    - Currently only constant thickness range-shifters are validated for clinical use.
  
 Should you discover or suspect any additional errors or limitations not noted above, please contact the .decimal astroid Dosimetry App development lead, Kevin, Erhart, at kerhart@dotdecimal.com with details of your concerns. All concerns will be addressed as quickly as possible and follow up with the submitter will occur throughout the inquire and correction process. Should you discover or suspect any additional errors or limitations not noted above, please contact the .decimal astroid Dosimetry App development lead, Kevin, Erhart, at kerhart@dotdecimal.com with details of your concerns. All concerns will be addressed as quickly as possible and follow up with the submitter will occur throughout the inquire and correction process.
dosimetry/userguide/userguide.1435851880.txt.gz · Last modified: 2021/07/29 18:21 (external edit)