Azaitsev: /* Documentation */

2010-12-08T00:39:56Z

Documentation

Azaitsev at 19:53, 9 August 2010

2010-08-09T19:53:45Z

Azaitsev: /* workflow proposed by Ron */

2010-08-09T19:53:22Z

workflow proposed by Ron

Azaitsev: Created page with '== July 7, 2010 == ===Alex's workflow (scenario as of discussion during presentation on June 12) === 1. Organize inputs: USER Activity 1.1. Select DICOM Series 1.2 Spe…'

2010-08-09T19:50:24Z

Created page with '== July 7, 2010 == ===Alex's workflow (scenario as of discussion during presentation on June 12) === 1. Organize inputs: USER Activity 1.1. Select DICOM Series 1.2 Spe…'

New page

== July 7, 2010 ==

===Alex's workflow (scenario as of discussion during presentation on June 12) ===

1. Organize inputs:
USER Activity
1.1. Select DICOM Series
1.2 Specify subject ID, time point, image modality
AUTOMATION:
1.3 Create Subject folder
1.4 Convert DICOM series into Slicer NRRD format
1.5 Save NRRD images in the Subject folder
1.6 Extract PET pharmaceutical data from DICOM headers. Save them in the Subject folder

2. Crop Volumes
USER Activity:
2.1 Select head region for PET/CT scans. For each time point.
2.2 Save cropped volumes
Question: do we only crop PET volumes here? Since we don't yet know the reference CT, and don't need to crop CT at each timepoint.

3. Create ROI Label Map
USER Activity:
3.1 Use Timepoint 1 cropped PET scan (AZ: technically, any PET scan can be selected for ROI label map building)
AUTOMATION:
3.2 Create blank label map that matches PET
USER Activity:
3.3. Identify ROI using custom color label lookup table (Slicer3 Feature)
3.4. Save ROI Label

4. Identify reference CT scan
USER Activity:
4.1. Point to appropriate CT volume
4.2. [Optional] Manual alignment of reference CT volume
4.3 [If 4.2 performed] Save Aligned CT volume

5. Launch Registration Pipeline
AUTOMATION:
5.1 For each timepoint, register PET scan to CT scan
5.2 For timepoint 1, safe transformation matrix from 5.1
5.3 For each timepoint, register CT scan to reference CT scan
5.4 For each timepoint, safe transformation matrix from 5.3.
5.5 For each timepoint, registered PET scans using transformation matrix from 5.4.
5.6 Resample ROI label map the reference CT using transformation matrixes from 5.2 and 5.4
5.7 Generate result review scenes descriptor files

6. Compute SUVs
AUTOMATION:
6.1 Merge PET pharmaceutical data with registered PET images' headers
6.2 Compute SUVs. Save results in CSV format in the Subject folder

7. Results Preview:
USER Activity
7.1 Load results' sets along with resampled RIO label map via Slicer scene files.
7.2 (TBD) Build time series intensity plots

=== workflow proposed by Ron ===
* Documentation:
*User Manual for workflow front-end Java GUI that includes proposed updates:
[[File:PETCT_UserGuide_QuickGuide_V0.doc]] 

*Recommended Sessions for Multiple Subjects Processing
[[File:PETCT_RecommendedSessions.doc]] 

* Calling Workflow instances and web services using Java stub (CLI interface) 
NOTE: this is one of the various ways to call WF and Web Services from Slicer 
This approach is similar to the XNATRestClient.jar usage 
[[File:PETCT_CLI_Client_Calls_V0.pdf]] 

*Web Services and WF Deployment 
[[File:PETCT_WS_WF_Deployment_V0.pdf]] 

'''Pending Updates:''' 
1. Hierarchical File Organizing 
2. Slice Comparison View for QA and Results Review 
3. Complete SUV computation services 

'''(First)'''
* tech (or we) organize data (maybe as described at bottom)

'''(Second)'''
* tech launches workflow engine GUI with root data dir as argument
** (code parses data dir to produce selectable items)
* tech chooses a patient by ID and chooses timepoint by number.
** code converts dcm->nrrd,
** extracts dcm headers and
** saves file into appropriate dir, (all under the hood)
** tech is shown '''choose registration reference step'''by default
** clicks go & slicer is launched with all CT scans for patient.
* tech chooses a ct reference by timepoint in workflow engine GUI.
** this clears Slicer scene and
** loads all pets plus ct reference into slicer
* tech crops all volumes for patient and manually saves them
* tech '''runs registration'''
** code checks to make sure all crop volumes are written.
** registers pet_i to pet_ref, -->pet_i',
** then pet_i' to ct_ref --> pet_i'',
** saves results into directory tree appropriately.

'''(Third -- QA)'''
* if not already running, tech launches workflow engine GUI with root data dir as argument
* selects patient.
* selects '''preview registration'''
** slicer launches or scene is closed in existing slicer;
** opens all cropped, registered volumes for patient
* tech reviews, if not good, goes back to '''choose reference step''' and repeat registration.

'''(Forth)'''
* laura launches workflow engine GUI with root data dir as argument.
* code parses data dir to produce selectable items)
* laura chooses a patient by ID and then '''drawVOI step'''.
** slicer is launched or scene is closed in an existing slicer;
** pet baseline is loaded,
** label map is created, and
** her color map is selected.
* she paints VOIs using editor, saves label map.
* repeats for none, some, or all patients.
* clicks '''compute SUV step'''
** workflow GUI shows all patients in directory who are ready for processing, and
** shows those that have already been processed.
* she modifies selection of patients for processing, clicks 'go' for all selected patients.
* goes home or out for coffee.
** processing is launched and run
** results are saved to appropriate dirs

'''(Fifth Step):'''
* later, laura/tech launch workflow engine with root data dir as argument.
* select single patient or ALL patients for '''viewing results step'''
* view tables & plot.

=== data organization suggestion ===
directory structure could be parsed and used to populate the GUI when the GUI client is launched with the root dir as a command line argument.

Then user chooses:

select patient {p_1, p_2, ..., p_N}:
select timepoint {t_1, t_2, ..., t_M}:

Maybe something the directory structure could look something like this, for all patients and timepoints:

input:
./patient_1/input/timepoint_1/pet_orig/petdata.dcm
./patient_1/input/timepoint_1/pet_orig/petdata.nrrd
(tech only needs to know about this. -- the rest of the
structure your logic would use as convention...)

convert:
./patient_1/convert/timepoint_1/ct/ctdata.dcm
./patient_1/convert/timepoint_1/ct/ctdata.nrrd
./patient_1/convert/timepoint_1/parameters/dicomheader.txt

reference:
./patient_1/reference/ct/ctdata.nrrd
./patient_1/reference/pet/petdata.nrrd

crop results:
./patient_1/crop/pet/timepoint_1/petdata.nrrd
./patient_1/crop/ct/ctdata.nrrd

registered data:
./patient_1/register/pet/timepoint_1/petdata.nrrd
./patient_1/register/voi/voi.nrrd

voi:
./patient_1/VOIs/voi.nrrd

suv:
./patient_1/results/suv/file.csv
./patient_1/results/plots/plotfiles.

study:
./results/suv/file.csv
./results/plots/plotfiles

← Older revision		Revision as of 19:53, 9 August 2010
Line 1:		Line 1:
		+	== Documentation ==
		+	*User Manual for workflow front-end Java GUI that includes proposed updates:
		+	[[File:PETCT_UserGuide_QuickGuide_V0.doc]] <br>
		+
		+	*Recommended Sessions for Multiple Subjects Processing
		+	[[File:PETCT_RecommendedSessions.doc]] <br>
		+
		+	* Calling Workflow instances and web services using Java stub (CLI interface) <br>
		+	NOTE: this is one of the various ways to call WF and Web Services from Slicer <br>
		+	This approach is similar to the XNATRestClient.jar usage <br>
		+	[[File:PETCT_CLI_Client_Calls_V0.pdf]] <br>
		+
		+	*Web Services and WF Deployment <br>
		+	[[File:PETCT_WS_WF_Deployment_V0.pdf]] <br>
		+
	== July 7, 2010 ==		== July 7, 2010 ==

← Older revision		Revision as of 19:53, 9 August 2010
Line 55:		Line 55:

	=== workflow proposed by Ron ===		=== workflow proposed by Ron ===
−	* Documentation:
−	*User Manual for workflow front-end Java GUI that includes proposed updates:
−	~~[[File:PETCT_UserGuide_QuickGuide_V0.doc]] <br>~~
−
−	*Recommended Sessions for Multiple Subjects Processing
−	~~[[File:PETCT_RecommendedSessions.doc]] <br>~~
−
−	* Calling Workflow instances and web services using Java stub (CLI interface) <br>
−	~~NOTE: this is one of the various ways to call WF and Web Services from Slicer <br>~~
−	~~This approach is similar to the XNATRestClient.jar usage <br>~~
−	~~[[File:PETCT_CLI_Client_Calls_V0.pdf]] <br>~~
−
−	*Web Services and WF Deployment <br>
−	~~[[File:PETCT_WS_WF_Deployment_V0.pdf]] <br>~~

	'''Pending Updates:'''<br>		'''Pending Updates:'''<br>

@@ Line 2: / Line 2: @@
 *User Manual for workflow front-end Java GUI that includes proposed updates:
 [[File:PETCT_UserGuide_QuickGuide_V0.doc]] <br>
 *Recommended Sessions for Multiple Subjects Processing

Projects:ARRA:SlicerWF:PETCTWorkflowDesign - Revision history

Azaitsev: /* Documentation */

Azaitsev at 19:53, 9 August 2010

Azaitsev: /* workflow proposed by Ron */

Azaitsev: Created page with '== July 7, 2010 == ===Alex's workflow (scenario as of discussion during presentation on June 12) === 1. Organize inputs: USER Activity 1.1. Select DICOM Series 1.2 Spe…'