Home

PowerTools User Manual

1. Findings Artery of Neck Right Doppler Pulsed Internal C Findings Artery of Neck Right Doppler Pulsed Intern Findings Artery of Neck Right Doppler Pulsed Internal C Findings Artery of Meck Right Doppler Pulsed Intern 72 mapping entries UE The Mapping File field is the path to a text file containing the Structured Report Search Terms and their corresponding mapped PowerScribe Custom Field values The Structured Report s field contains the path to a file or folder of structured report data to be parsed and then used to create a Mapping File Other features of the Structure Report Extractor are e Mapping File tab displays a table of mapping values which map the Structured Report Search Term the complete branch name of an element with a PowerScribe Custom Field a simplified branch name with all spaces replaced by underscore characters e Extraction Summary tab displays summary output from the structured report parser e Auto Text Dictionary tab displays an example Auto Text Dictionary that can be used for reference or as a Starting point for creating or troubleshooting application use of mapping names and their structured report data values e Load when clicked the currently selected Mapping File to be loaded into the Mapping File tab Any mapping data l
2. attempts As Encoded Transfer Syntax Only and if that fails then the image will be sent using the desired client transfer syntaxes for presentation context negotiation list if possible the transfer syntaxes at the top of the list will be given a higher priority o SCP Preferred Transfer Syntax Only images will be sent in whatever transfer syntax the SCP prefers o SCU Preferred Transfer Syntax Only images will be sent using the desired client transfer syntaxes for presentation context negotiation list if possible the transfer syntaxes at the top of the list will be given a higher priority PowerTools User Manual 2015 Laurel Bridge Software Inc All Rights Reserved v1 0 34 24 4 2 3 Verification Client Verification Client connects to a remote server and checks to see if it 1s currently running both ICMP ping and DICOM C Echo tests are performed Its functionality 1s available in every client application and will not be described further 4 2 4 Modality Worklist Client Modality Worklist Client provides a command line interface to common functionality of a modality worklist client suitable for testing troubleshooting and as a developer tool Using the command line interface query parameters can be specified either directly using the q flag or via a configuration file For example a command line query for all patients that have the word Simpson in their name and have a Patient ID of 112233 and return
3. Note For a valid DICOMDIR the directory structure and filenames passed into this application must meet DICOM standards This application will create a DICOMDIR using any directory structure even if it results in a technically invalid DICOMDIR A valid directory structure looks like this SUBDIR 145UBDIR 21S UBDIR3YFILENAME Note that each subdirectory and the filename must be all uppercase characters numbers or the character and can be no more than 8 characters long The hierarchy must also be 8 levels deep or less The filename must not have a filename extension 4 4 2 DICOM File Editor DICOM File Editor provides a three tabbed view for inspecting DICOM files a tabular view of the header contents a hex viewer and an image viewer for the pixel data It is recommended to set the DICOM File Editor as the default viewer for DCM files in Windows to enable faster viewing editing of image files Some advanced settings for this application are described below The DICOM File Editor menu bar has several options unique to the application PowerTools User Manual 2015 Laurel Bridge Software Inc All Rights Reserved v1 0 34 34 New Ctrl M Open Ctrl Q Recent Files Import From Export To Save Ctrl 5 Save As Save Image As Save Header s Text Print Preview Print Ctrl P Close Clear All Exit File Menu e File o New creates a new DICOM data set for editing o Open opens a DICOM file
4. converts a DICOM image into a PDF Dictionary Finder displays data from the DICOM data dictionary Indexer iterates over images and indexes specified tags into a csv file MWL Client connects to a modality worklist SCP MWL Server provides a modality worklist SCP for a directory on disk Query Client queries a query SCP or PACS for DICOM images and can move DICOM images from the server to another location Query Server provides a query SCP for a directory on disk Store Client stores DICOM images from disk to a store SCP Store Server receives C Store DICOM images from a store SCU Study Generator generates DICOM image studies and stores or writes them Verification Client verification SCU to send C Echo requests Verification Server verification SCP to receive C Echo Note that occasionally some new tools which are not listed above may be included in intermediate release versions of PowerTools providing an early look at upcoming additions to the suite 1 3 Important Features All of the applications in PowerTools have been written with easy to understand interfaces In an effort to make PowerTools even easier to use each application has built in features designed to make understanding and using the application a more natural and less frustrating experience In all GUI applications most items on the screen have a tooltip which can be displayed by hovering the mouse pointer over the item
5. 30 00 08 00 00 00 31 39 37 38 30 37 30 32 0 19780702 10 00 40 00 02 00 00 00 4D 20 10 00 05 10 valla ens E ask OE 00 00 00 6D 69 6E 65 72 SE 73 74 65 70 liner step 68 65 6E 20 10 00 10 10 04 00 00 00 30 31 Ren barske 01 y Listing 1 patient 1 study 1 series 1 instance from 1 directory Viewing mr knee dcm 132 848 bytes Hexadecimal byte values corresponding to the Institution Name element are highlight in the hex view panel PowerTools User Manual 2015 Laurel Bridge Software Inc All Rights Reserved v1 0 34 414 Right clicking on highlighted bytes in the hex view panel enable those bytes to be copied to the Clipboard both as binary values and text values for pasting into applications that accept either binary or text CLEMENS j AT Ce Lo rer i ca 3 3 3 B 0 32 B3 c Mo Coh i SelectAll I 00 50 69 63 6B T C tn c w D cm Highli ghted bytes can be copied to the Clipboard Note that Cut and Paste operations are not supported in the Dicom File Editor When any byte in the DICOM preamble for which there 1s no corresponding DICOM element is selected the entire preamble is selected in the hex viewer panel and a descriptive tooltip is displayed mr knee dcm c j Em c c c c c c c j ca 3 MI Le E ne Le E e Le RN ne c LE c c 6 c E ooo oo C e ue en co oo ca we 23 c e i L2 ue c Cc
6. LO 14 Patient ID 000003F136E8A UI 54 Study Instance UID 0 1 3229014446 1265295723 2160 969861 6 2 2 Creating a Filter File To create a filter file using Filter Editor in the GUI version of the Query Client application run the Query Client open the Options dialog from the Tools menu and click on the Edit Filters button The Filter Editor dialog will open Type Inbound Filters Filter Editor z m Import Export Filter Conditions Actions kel OK Cancel Click the amp button to add a new filter Then in the Conditions area select Dicom Tag and define it as Patient s Name with a condition of Exists In the Actions area select Change Case for Patient s Name and define the action as Lower The dialog should now look like this PowerTools User Manual 02015 Laurel Bridge Software Inc All Rights Reserved v1 0 34 63 Filter Editor g Type Inbound Filters r Import Export Mew Filter 1 J Bl Actions h Use Original Attributes Sequence Change Case Eb nr 3 Upper Lower OK Cancel Finally click Export and save this filter with a meaningful name such as filter xml Close all dialogs and exit from the GUI version of the Query Client For convenience this same Filter Editor 1s available in the GUI versions of the DICOM Filter DICOM File Editor Store Client Store Server Verification Client and Verification Server applications
7. e VR the value representation type of the DICOM element VM read only field describing the value multiplicity usually 1 but will be greater for multi valued elements Value s the values for the DICOM element with each value on a new line Validate validates the DICOM element to make sure all fields are DICOM valid OK saves the element and exits the dialog Cancel exits the dialog without saving 4 4 3 DICOM Filter DICOM Filter allows for the filtering of multiple DICOM image files on the disk For example if a patient s name was spelled incorrectly in an entire study of hundreds of images simply select the directory containing the images and add a filter to correct the name The functionality in this application 1s shared with other applications and will not be described further 4 4 4 Dictionary Finder Dictionary Finder provides the ability to search the DICOM data dictionary for a particular UID unique identifier or for a specific DICOM element Settings for this application are described below Dictionary Finder Laurel Bridge Software a File Tools Help SOP Classes Transfer Syntaxes Attribute Tags VR Names Find patient Contains Tag Code Tag Name VR VM a 0008 1120 Referenced Patient Sequence S0 1 0010 0021 Issuer of Patient ID IO 1 0010 0022 Type of Patient ID CS 1 0010 0024 Issuer of Patient ID Qualifiers Sequence S0 1 0010 0030 Patient s Birth Date DA 1 0010 0032 P
8. Use SAMPLE watermark Override bits allocated amp stored see tooltip 02015 Laurel Bridge Software Inc All Rights Reserved oelect Study Series or Image Send images in various Sizes view in Store Server Tools gt Load Extra Tags select example set 27 1 Shown only when Background Image is used Add Bits Allocated and otored tags in Tools menu modify values v1 0 34
9. 1 e MONOCHROME 2 e RGB All other photometric interpretations will cause an error unless Skip Unsupported Images 1s enabled Note that multi frame images are not supported for pixel data anonymization 5 2 4 One Way Anonymization For one way anonymization of the patient demographic data and or pixel data re identification cannot be performed the following feature must be unchecked in the Misc Settings group box 5 2 5 Enable Re Identification NOTE If the Enable Re Identification setting 1s enabled without a valid Public Certificate the de identification will fail with the following error LaurelBridge DCS DC S Exception Failed to apply filter action gt System Security Cryptography CryptographicException Cannot find the requested object The Public Certificate Path text box will be disabled when performing one way anonymization A valid public certificate 1s only necessary when Enable Re Identification 1s checked A valid certificate should either be purchased or generated by the user The expected certificate file formats are e the public certificate export format PEM crt e the private certificate export format PKCS 12 p12 5 2 6 Additional Notes Pixel data and header data re identification are only available with a valid public and private certificate PowerTools User Manual 2015 Laurel Bridge Software Inc All Rights Reserved v1 0 34 58 Disable Use Original Attributes Sequence for all de
10. A mr knee dcm x Patient PIKR 752962 1 study Study 2 16 7602350 10 1series zb m0 x Image Tag Code A Tag Name Length Value 5 2 i 0008 0023 Content Date 1 8 19970926 o ME 1 0008 0030 Study Time 1 8 154322 0 z 0008 0031 Series Time 1 8 155107 0 0008 0033 Content Time 1 8 155712 0 00038 0050 Accession Number 1 8 PIKR0004 0008 0060 Modality 1 2 MR i 0008 0070 Manufacturer 1 26 Picker International Inc 7 0008 0080 Institution Name GOOD DELAWARE HOSPITAL 0 52 5522 52232238 00080090 Referring Physician s Name 1 0008 1010 Station Name 1 8 afil4 ws 0008 1030 Study Description 1 32 KNEE RIGHT QUAD KNEE LG JOINT 0008 1090 Manufacturer s Model Name 1 6 HF1006 0010 0000 Group Length 1 4 94 i 0010 0010 Patient s Name 1 26 minner stephen 0010 0020 Patient ID 1 10 PIKR752962 0010 0030 Patient s Birth Date DA 1 8 19780702 0010 0040 Patient s Sex CS 1 2M L NAIN INNE Datantc Rirth Mama DN 1 14 miner etanhan tal 4 b Listing 1 patient 1 study 1 series 1 instance from 1 directory Viewing mr knee dcm 132 848 bytes Institution Name is highlighted in the header view panel Hovering over the Length of any element in the header view panel will cause a descriptive tooltip to pop up reporting on the total number of bytes stored in the file for that element including the number of bytes in its header 16 ORIGIMAL PRIMARY JA 12 RAN innnga 514114 Bytes stored ind
11. DROC_NUMBER_1 20020625 US 22223333 20100615 444 Simpson Lisa 112266 5 DROC_NUMBER_1 20020625 MR 33334444 20120531 333 Simpson Maggie 112255 Server Host localhost Server Port 11113 Verify Query Type amp Method MWL Relational v Move AE Title Root Study ae Level Study Tags Add Remove Y Tag Name Value 0040 Scheduled Proc f 004 Scheduled Stati P004 Scheduled Proc i 000 Modality 0020 Study Instance i 0008 Study Date m Use Default Tags View Log Query Successful 5 responses received Total Elapsed Time 0 00 00 023 PowerTools User Manual 2015 Laurel Bridge Software Inc All Rights Reserved v1 0 34 7 Application Summary There are three forms of applications in PowerTools combined GUI and console applications GUI only and console only For clarity they are listed here Usage information for the GUI version of applications and console only applications 1s displayed using the h flag while usage information for the console version of combined GUI and console applications 1s displayed using both the a h and the nogui flags 7 1 Feda Jal PowerTools User Manual Combined GUI and Console Applications DICOMDIR Creator DICOM File Editor DICOM Filter Dictionary Finder Query Client Store Client Store Server Study Generator Verification Client Verification Server GUI only Applications PDF to DICOM HL7 Receiver HL7 Se
12. Identification Retain Date and Time Information Skip Unsupported Images PowerTools User Manual 2015 Laurel Bridge Software Inc All Rights Reserved v1 0 34 55 5 2 1 DICOM Attribute Tags to Anonymize By default this list is populated with attributes suggested in PS 3 15 Annex E Attribute Confidentiality Profile in the 2011 DICOM specification Attribute Tags not in the default data dictionary cannot be added This includes specific private tags The following options are specified for each attribute in the data grid shown above under DICOM Attribute Tags to Anonymize Attribute Tag Name Specifies the name of the attribute tag to be anonymized if present in a given DICOM dataset s header data VR Indicates the attribute s Value Representation This becomes useful when determining an appropriate replacement value for de identification when AutoFill is selected Tag Indicates the attribute tag of the attribute to be anonymized Action Specifies the replacement action to use for a given attribute when determining the replacement value The available replacement actions are determined based on the attribute s VR The following list contains all available replacement actions o Hash SH LO PN elements For SH LO and PN elements the replacement value will be a trimmed hash string using SHA256 of the original value o GenerateUID For a given UI element a new UID will be generated for the repla
13. This tooltip displays information about the item which can be helpful for understanding the item s purpose For console applications running the applications with the h flag will display the usage for the application listing a description of all possible flags and arguments Using the h flag with GUI applications will display usage information in a pop up window while adding the nogui flag to many of the GUI applications will display command line usage for the console versions of the applications PowerTools User Manual 2015 Laurel Bridge Software Inc All Rights Reserved v1 0 34 Many of the GUI and command line software applications in PowerTools incorporate innovations in user interface ease of use and the robustness of the underlying DICOM framework or HL library upon which most of the Laurel Bridge PowerTools applications are built An interesting innovation is built into the Study Generator command line tool is the inclusion of a first and last name database culled from recent U S Census Bureau statistics enabling the random generation of realistic looking patient names in roughly the same frequency with which the names occur in the general population PowerTools User Manual 2015 Laurel Bridge Software Inc All Rights Reserved v1 0 34 2 Installation To install PowerTools run the installer executable Setup exe and follow the on screen directions 2 1 Prerequisites PowerTools uses several prerequisite components
14. Title 0002 0100 Private Information Creator UID 0002 0102 Private Information 0004 1130 File set ID 0004 1141 File set Descriptor File ID Extra Tags with group and element numbers displayed Tag Selecting Delay each store by supports inserting a delay of a configurable number of seconds between each store operation Each store can be delayed by exactly or up to a desired number of seconds from 0 0 to 99 999 seconds The console version of the Study Generator makes use of a configuration file that controls generation of a variety of Patient Study Series and Image tags A number of built in functions support generation of random values for UID date time name and gender Detailed instructions are contained in the example configuration file StudyGeneratorExample cfg found in the PowerTools installation directory along with a small example DICOM file mr knee dcm that can be used as a template for generating studies 4 3 DICOM Server Applications PowerTools provides several DICOM server applications which receive connections from a DICOM client on a remote machine The more advanced functionality of these applications 1s discussed below PowerTools User Manual 2015 Laurel Bridge Software Inc All Rights Reserved v1 0 34 29 4 3 1 Store Server The Store Server provides DICOM SCP functionality Received images are displayed in a grid display with each row in the grid representing all images received within the same ass
15. all DICOM datasets with a photometric interpretation of YBR FULL will automatically be skipped The header data for these datasets will still be anonymized For a list of all supported image types see section 5 2 3 Pixel Regions to Anonymize e Private Group The Private Group box specifies which group will be used during the de identification process In particular after De Identification this private group will hold the Encrypted Attribute Sequence containing the original data e Enable Logging Checking this option will enable logging for the de identification process 5 23 Pixel Regions to Anonymize This grid specifies which rectangles to anonymize in a DICOM dataset s pixel data 7FEO 0010 Each rectangle is defined by indicating the location of each side of the rectangle in relation to the original image specified in terms of a percentage For instance the example form shows two rectangles covering the entire top and bottom 10 percent of an image Clicking Configure allows the user to define an appropriate replacement pixel value for each type of supported photometric interpretation via the following dialog box PowerTools User Manual 2015 Laurel Bridge Software Inc All Rights Reserved v1 0 34 57 r Replacement Pixel Color MONOCHROME 1 128 MONOCHROME2 fo R G B p pP pP RGB The supported photometric interpretations for de identification are as follows e MONOCHROME
16. bit images are generated The Options dialog in the Study Generator provides support for Logging as well as two additional settings Options Log Level View Log Dicom Terse View Log Directory Settings Show group amp element numbers in Extra Tags list l seconds Delay each store by exactly 00 000 By selecting Show group amp element numbers in Extra Tags list the group and element numbers are displayed in the drop down list of Extra Tags to support locating tags by group and element number in addition to tag name PowerTools User Manual 2015 Laurel Bridge Software Inc All Rights Reserved v1 0 34 28 Extra Tags Store Server Profiles Tag Name Mame Default 2D Degree of Freedom Axis 2D Implant Template Group Member Matching Axes 2D Implant Template Group Member Matching Point 2D Line Coordinates 2D Mating Axes 2D Mating Point 2D Plane Intersection 2D Point Coordinates 3D Degree of Freedom Axis 3D Implant Template Group Member Matching Axes 3D Implant Template Group Member Matching Point Extra Tags with no group and element numbers TT Tag Generate Extra Tags Store Server Profiles Tag Name m Mame Default 0002 0001 File Meta Information Version 0002 0002 Media Storage SOP Class UID 0002 0003 Media Storage SOP Instance UID 0002 0010 Transfer Syntax UID 0002 0012 Implementation Class UID 0002 0013 Implementation Version Name 0002 0016 Source Application Entity
17. changes made to the selected options 4 34 DICOM Client Applications PowerTools provides several DICOM client applications which connect to a DICOM server on a remote machine and transmit DICOM communication The advanced functionality of these applications is discussed below 4 2 1 Query Client Query Client can query a query SCP containing a database of DICOM images and request information about certain 1mages It has both console and GUI versions Using the command line interface query parameters can be specified either directly using the q flag or via a configuration file For example a command line query for all patients that have a Patient ID of 112233 and returning those values plus Accession Number and Referring Physician looks like this QueryClient other params q 0008 0050 q 0008 0090 g 0010 0020 112233 Instructions for using a configuration file to perform queries are contained in the example configuration file QueryClientExample cfg found in the PowerTools installation directory Query Client includes three query modes Find Move and MWL described by Query Type and two search methods Relational and Hierarchical described by Query Method Find mode queries a query SCP for DICOM data sets which contain DICOM elements which match the tags selected in the GUI Tags with an empty value will be populated upon response from the server PowerTools User Manual 2015 Laurel Bridge Software Inc All Rights Reser
18. identification filters if you are going to anonymize SOP instances Having this option enabled will defeat the purpose of anonymization by embedding the list of attribute tags and their original values that changed after applying the de identification filter action The De Identify Filter Action also supports removing all private tags from the DICOM dataset s header data The current options and their descriptions are as follows e Do Nothing Leave the private tags as they are By default this option is selected e Remove All Remove all private tags from the DICOM dataset s header data This does not include any private tags added during the de identification process This removal 1s unidirectional and cannot be undone even during re identification e Encrypt All Remove all private tags from the DICOM dataset s header data This does not include any private tags added during the de identification process This option can only be enabled if Enable Re Identification is selected and a valid public certificate is provided 5 3 Re Identify Filter Action Orginal SOP Instance UID Handling fe Restore Original UID Create a New UID and Reference Original Create a New UID and Do Not Reference Original Enable Logging The Re Identify Filter Action allows restoration of previously anonymized patient demographic information and pixel data for a given DICOM dataset The patient demographic information and pixel data
19. of the query configuration file format see below or view the example QueryClientExample cfg file in the PowerTools installation directory 2 Create a filter file using the GUI version of the Query Client application A simple filter to create for this example would be one that modifies the Patient s Name by changing its case to all lowercase See below for a description of using the Filter Editor in one of these applications to create an XML filter file saving it as filter xml 3 Run the Query Server console application pointing it at a directory that contains at least one dataset that matches the query defined in query txt like this Queryberver 11112 path to dataset folder 4 Query the server using the console version of the Query Client taking care to use the required nogui switch like this QueryClient localhost 11112 nogui f query txt fi filter xml Be sure either to have the query txt and filter xmI files in the same directory from which you are running the command or to specify on the command the complete path to each file PowerTools User Manual 2015 Laurel Bridge Software Inc All Rights Reserved v1 0 34 62 The output will look something like this noting that the Patient s Name is now lowercase Query Result 1 00087 0020 0008 0052 00107 0010 ODIO QUID 0020 000d tk Poe JODL DA 8 Study Date 20070101 CS 6 Query Retrieve Level STUDY PN 12 Patient s Name doe john
20. pops up A description and screen capture of the Using Wildcards dialog is contained above in the Dicom File Editor description section 4 4 2 The Dictionary Finder provides access to loading and managing an external data dictionary section 4 1 8 The external data dictionary indicator can be shown or hidden using the Show External Dictionary Indicator option in the Tools menu Dictionary Finder File Tools Help Revert To Factory Settings Show External Dictionary Indicator 4 4 5 PDF to DICOM The PDF to DICOM tool enables one or more existing PDF files to be converted to DICOM Encapsulated PDF files which optionally can be written to files on the local disk or stored to a PACS A sequence of screens guides the user step by step through the conversion process The user first selects one or more PDF files to encapsulate Next a data entry step allow DICOM tag values to be customized Finally the user selects an output directory to which the DICOM Encapsulated PDFs will be written or optionally the Hostname or IP address Port number Called AE and Calling AE of a PACS to store the files PowerTools User Manual 2015 Laurel Bridge Software Inc All Rights Reserved v1 0 34 46 4 4 6 Structured Report Extractor The Structured Report Extractor is a tool that parses one or more DICOM Structured Report files It is designed specifically to generate a mapping file for use with the Laurel Bridge Software Compass product and
21. the amp button and confirm deletion of the profile Delete Delete My Mew Profile store server profile from list There is no direct way to rename a store server profile To effectively rename a profile select the profile to be renamed e g Old Profile add a new profile e g New Profile with the desired new name and then delete the first profile 1 e delete Old Profile The Tools menu provides access to the Options dialog and to a variety of time saving shortcuts PowerTools User Manual 2015 Laurel Bridge Software Inc All Rights Reserved v1 0 34 aD File Tools Help Sti ptions Ctrl T Study Size Pa Load Extra Tags Simple Example Clear Extra Tags Bits Allocated and Stored Revert To Factory Settings Columns and Rows Modality and Media Storage Study Override o Options launches the Options Dialog see below o Load Extra Tags provides five convenient selections that will populate the Extra Tags list with the indicated tags Note that a tooltip will pop up for each of these selections providing information about the tags that will be added o Clear Extra Tags clears all tags from the Extra Tags list o Revert To Factory Settings resets the application to its initial settings When loading the Bits Allocated and Stored tags the user can indicate generation of 8 or 16 bit images by setting the appropriate value in the Bits Allocated tag If not indicated 8
22. the bytes adjacent to 1t 1s highlighted in the header view panel When an element is highlighted in one image and a different image 1s selected for viewing the same element in the newly selected file will be highlight if present DICOM File Editor Laurel Bridge Software mr knee dcm zm EN File Tools Help A mr knee dcm x Hex Image Patient PIKR 752962 1 study 5 Study 2 16 7602350 10 1series 08 00 00 00 31 39 39 37 30 39 32 36 08 00 19970926 Series 2 1 29304176 1instance 30 00 08 00 00 00 31 35 34 33 32 32 2E 30 O 154322 0 3 08 00 31 00 08 00 00 00 31 35 35 31 30 37 1 155107 2E 30 08 00 33 00 08 00 00 00 31 35 35 37 0 3 1557 31 32 2E 30 08 00 50 00 08 00 00 00 50 49 12 0 P PI 4B 52 30 30 30 34 08 00 60 00 02 00 00 00 Kroop4 4D 52 08 00 70 00 1A 00 00 00 50 69 63 6B A MR p Pick 72 20 er Internation al inc fees GODD DELAWAR E HOSPITAL 31 31 34 5F 77 73 08 00 30 10 20 00 00 00 114 Ws D 4B 4E 45 45 2D 52 49 47 48 54 20 28 51 55 KNEE RIGHT QU 41 44 20 4B 4E 45 45 2F 4C 47 20 4A 4F 49 Ap KNEE LG JOI 4E 54 29 20 08 00 90 10 06 00 00 00 48 46 NT HF 31 30 30 36 10 00 00 00 04 00 00 00 5E 00 TB EE 00 00 10 00 10 00 1A 00 00 00 2A 2A 2A 2A o e 2A 2A 2A 2A 2A 2A 2A 6D 69 6E 6E 65 72 SE eeeere ei nner 73 74 65 70 68 65 6E 20 10 00 20 00 0A 00 stephen 00 00 50 49 4B 52 37 35 32 39 36 32 10 00 PI R752962
23. third party systems such as PowerScribe 360 PS360 though it can be used more generally to reveal the fields and values contained in one or more DICOM Structured Reports File Tools Help pi Structured Report Extractor Laurel Bridge Software EO Mapping File C Wemp srdemo mapping file txt Structured Report s C temp srdema Mapping File Extracton Summary Patent Characteristics Subject Age Structured Report Search Term Patient Characteristics Subject Sex Auto Text Dictionary PowerScribe Custom Field Patient Characteristics Subject Age IDGDIR E EI sr Findings Artery of Abdomen 2D mode Spleen Mean Use Findings Artery of Abdomen 2D mode Spleen Mean Findings Artery of Abdomen 2D mode Bile duct Mean U Findings Artery of Abdomen 2D mode Bile duct Mea Findings Artery of Abdomen 2D mode Gall Bladder Mea Findings Artery of Abdomen 2D mode Gall Bladder M Findings Vascular Structure Of Kidney Right 2D mode Ki Findings Vascular Structure Of Kidney Right 2D mod Findings Vascular Structure Of Kidney Left 2D mode Kid Findings Vascular Structure Of Kidney Left 2D mode Findings Artery of Neck Right Doppler Pulsed Internal C Findings Artery of Meck Right Doppler Pulsed Intern
24. to be displayed in a tooltip mr knee dcm Tag Code A TagName e 0002 0000 Group Leng 0002 0001 File Meta Ir 0002 0002 Media Store gt 0002 0003 Media Stor Z 0002 0010 Transfer SY Length 132 848 bytes 0002 0012 Implementation Class UID Right clicking on any of the three tab headers or anywhere on the Image panel will cause a context menu to pop up enabling the currently displayed DataSet file to be shown in its folder on the file system Show in Folder saved as a regular image BMP GIF JPEG PNG TIFF Save Image As or have the path of the DataSet file copied to the system Clipboard Copy File Path to Clipboard show in Folder Save Image As Copy File Path to Clipboard When an element has an invalid value it is displayed with red highlighting below Specifically this 1s an indication that the VR validator has failed and that the element value has an invalid length PowerTools User Manual 2015 Laurel Bridge Software Inc All Rights Reserved v1 0 34 sd 155712 0 PIKROO04 MR Picker International Inc GOOD DELAWARE HOSPITAL i D008 0033 Content Time i 0008 0050 Accession Number i 0008 0060 Modality 0008 0070 Manufacturer i 0008 0080 Institution Name 0008 0090 Referring Physician s Name 2 0008 1010 Station Mame 0008 1030 Study Description L 0008 1090 Manufacturer s Model Name P 0010 0000 Group Length i 0010 0010 Patient s Name LONGER STRING THAN SH ALLOWS
25. works on a per user basis each user will need to install a valid license to run any of the utilities About PowerTools LAUREL BRIDGE PowerTools laurelbridge FA PowerTools v 1 0 33 PowerTools is up to date 2009 2015 Laurel Bridge Software Inc Powered by LBS DICOM Connectivity Framework DCF v 3 3 52c 2000 2015 Laurel Bridge Software Inc License Info Customer BCSI Expires 12 31 2012 Activate License Install License 3 2 Activating a License over the Internet Clicking the Activate License button will open the License Activation form You will need to provide a 16 digit product serial number Product S N to activate your license All fields on the form should be filled out When the License Activation dialog first appears it will attempt to contact the Laurel Bridge license server and pre populate the form with as much information as it has available If PowerTools cannot reach the license server you will be presented with an information message describing which fields need to be entered to activate your license on the Manual Product Activation interface on the Laurel Bridge Customer Access web page here https www laurelbridge com product activation php PowerTools User Manual 2015 Laurel Bridge Software Inc All Rights Reserved v1 0 34 License Activation Product amp Name PowerTools Ver 1 0 33 amp Product S N F 3BHIF 7 7AB4 5006 amp ARC 9677 0134 E48
26. 1 directory Tag Code 0008 0016 H 0008 0018 0008 0020 H 0008 0021 0008 0023 0008 0030 0008 0031 0008 0033 0008 0050 0008 0060 0008 0070 0008 0080 0008 0090 i 0008 1010 0008 1030 0008 1090 0010 0000 0010 0010 0010 0020 AAI PIN mr knee dom A Tag Name SOP Class UID SOP Instance UID Study Date Series Date Content Date Study Time Series Time Content Time Accession Number Modality Manufacturer Institution Mame Referring Physicians Name Manufacturer s Model Name Group Length Patient s Name Patient ID Puben Ged Pub VR VM Ul UI DA LO LO PN LO HR Re Eb H e pb pb GE bo ma a Viewing mr knee dcm 132 848 bytes EM Hex Image Length Value 26 1 2 840 10008 5 1 4 1 1 4 62 2 16 84 1 113662 4 87968 18069641 8060106 8 19970926 8 19970926 8 19970926 8 154322 0 8 155107 0 8 155712 0 amp PIKROOO4 2 MR 26 Picker International Inc 22 GOOD DELAWARE HOSPITAL 0 8 afii4 ws 6 HF1006 4 54 26 inner stephen 10 PIKR 752962 O AMAA Highlighting after a Find All operation for the search term study When Use wildcards 1s selected a limited set of wildcard notation 1s available to enable more powerful and flexible searching Selecting the help icon next to Use wildcards opens the Using Wildcards dialog that contains a summary of the wildcard syntax PowerTools User M
27. 112 Write Images To Disk C temp tempstoreserver tomtestfri SCP started Total Associations Recerved 3 Total Images Recerved 12 E Main user interface screen of the Store Server PowerTools User Manual 2015 Laurel Bridge Software Inc All Rights Reserved v1 0 34 30 Customize File 000001 dom zs File 000002 dcm E Patient s Name DOE JOHN Patient s Name DOE JOHN Patient ID ddd69a93 Patient ID ddd69a93 Accession Number AF75694CE3E05 Accession Number AF75694CE3E05 Modality CT Modality CT Study Date 20141016 Study Date 20141016 Image Thumbnail Image Thumbnail 1 Clicking on a thumbnail image will open the underlying DICOM image file in the Dicom File Editor Patient ID AEGIS DEMO Accession Number Modality US Study Date 19990219 Number of Frames 30 Image Thumbnail The Number of Frames in a multi frame image is shown For DICOM image files that do not contain viewable image data a No Image indicator is displayed on the Image Thumbnail File 00000 1 dem E Patient s Name WAY THOMAS Patient ID 1234567 Accession Number ACC012345 Modality RTSTRUCT Study Date 20141031 Image Thumbnail No Image The No Image indicator PowerTools User Manual 2015 Laurel Bridge Software Inc All Rights Reserved v1 0 34 23 Large numbers of image and log files can be generated in the process of running the Store Server To assist with file system cleanliness when
28. 23 2014 wl Today vl Tag Overlay w Use separate association per Study w Store studies in parallel Extra Tags Store Server Profiles Tag Name GO Name Default 0 Tag 0008 0050 o Host localhost 0010 2180 Occupation Bus Driver d Port iiiiz 0008 0090 Referring Physician s Dr Marcus Welby M D i CalledAE SCP CalingAE SCU Click Generate to send images Study Generator main user interface One or more Store Server Profiles can be defined with the list of profiles each containing a Host Port CalledAE and CallingAE persisting across uses of the Study Generator To add a new store server profile click the amp button and enter a new profile name into the dialog PowerTools User Manual 2015 Laurel Bridge Software Inc All Rights Reserved v1 0 34 26 Add Store Server Profile Enter a name for a new store server profile My New Profile Once a profile has been added to the list of profiles its values can be directly edited in the main GUI screen by first selecting the desired profile name from the list and then editing the four values underneath Note that when adding a profile the Host Port CalledAE and CallingAE values for the currently selected profile will be copied into the newly added profile Store Server Profiles Name My New Profile 0 9 Host Port 111123 CalledAE SCP CalingAE SCU To delete a store server profile select the desired profile in the list and click
29. 7 Application Window Renaming All of the client and server GUI applications have the ability to rename the application window title bar which can be helpful when running multiple instances of the same application A Rename Title Bar A Rename Title Bar Enter a new name for the ttle bar Enter a new name for the tite bar Store Server Laurel Bridge Software Store Server 5 Cancel OK Cancel Entering a new name in the Store Server application renaming dialog The renaming dialog is activated by hitting the F2 key the default Windows file and dialog renaming key shortcut when the application is open and has focus E Store Server Laurel Bridge Software cg Store Server 5 oig File Tools Help File Tools Help Input Running Input Runnin g Start Time A Called AE Title Calling AE Title Calling Presentation Address Image Count Status Start Time A Called AE Title Calling AE Title Calling Presentation Address Image Count Status Client AE Title SCU Allow Any Server AE Title SCP Allow Any Client AE Title SCU Allow Any Server AE Title Client IP Address 127 0 0 1 Allow Any Server Host Default Y Client IP Address 127 0 0 1 Allow Any Server Host Default v Client Port 2000 Allow Any Server Port 11112 Client Port 2000 Allow Any Server Port 11112 Write Images To Disk Write Images To Disk SCP started Total Associations Received 0 Total Images Received 0 A SCP started Total Associations Received 0 Total Images Received 0 A PowerTool
30. B 1 2 0x01 0x00 EEE 0002 0002 Media Storage SOP Class UID UI 1 20 1 2 840 10008 11 45 i 0002 0003 Media Storage SOP Instance UID UI 1 54 2 16 840 1 113662 4 8796818069641 0002 0010 Transfer Syntax UID Ul 1 18 Implicit VR Little Endian 0002 0012 Implementation Class UID UI 1 24 2 16 840 1 113662 4 2 1 i 0008 0000 Group Length UL 1 4 396 0008 0008 Image Type CS 2 16 ORIGINAL PRIMARY La 0008 0016 SOP Class UID UI 1 26 MR Image Storage i 0008 0018 SOP Instance UID Ul 1 62 2 16 840 1 113662 4 8796818069641 0008 0020 Study Date DA 1 8 19970926 i 0008 0021 Series Date DA 1 8 19970926 00038 0023 Content Date DA 1 8 19970926 i 0008 0030 Study Time 1 8 154322 0 0008 0031 Series Time TM 1 8 155107 0 0008 0033 Content Time TM 1 8 155712 0 0008 0050 Accession Number 1 8 PIKRO004 i nnne NNAN Madslitu re 1 7 MD 4 b Listing 1 patient 1 study 1 series 1 instance from 1 directory Viewing mr knee dcm 132 550 bytes The header view of the DICOM File Editor lists the DICOM elements loaded from the selected DICOM file in the navigation area Each element can be edited by double clicking the element except for sequence items Also right clicking any element in the display will provide a different context menu depending upon the type of element selected PowerTools User Manual 2015 Laurel Bridge Software Inc All Rights Reserved v1 0 34 39 DICOM File Editor Laurel Bridge Software mr knee dcm BG File Tools Help
31. D RANDOLPH 7101 E STRADA JAIME P DRII 314 Messages Sent 1 Cancel Using Macro Replacement Simple Replacement Macro Replacement provides a simple convenient and powerful mechanism for automating HL7 message formatting To use Macro Replacement define a Macro Name that will be embedded in the message template and a Replace Value that determine the replacement behavior of the Macro Name The Replace Value can be a simple string or one of the pre defined macro functions For simple string value replacement first define the desired Macro Name and ReplaceValue ORM O01 13450604 M WH 82 Using Macro Functions Macro functions are used to insert generated values at a specific points in an HL7 message To use macro functions define a Macro Name as before Insert a macro name string in the message template at the point you want the replacement to occur PowerTools User Manual 2015 Laurel Bridge Software Inc All Rights Reserved v1 0 34 51 For the Replace Value use one of the following functions TIMESTAMP TIMESTAMP format This macro function will generate a date and time stamp in a desired format The format is defined using standard date string formatting For reference refer to the online MSDN Custom Date and Time Format Strings documentation Leaving the format empty will generate a timestamp for the current date and time For example to insert the current month day and year define the Re
32. Dict tonaryFinder vshost exe HLYReceiver exe HLYReceiver vshost exe HLYSender exe Indexer exe Launcher exe Launcher vshost exe MwlClient exe MulGlientExample cfy MwlServer exe Pdf ToDicom exe Pro jectTemplate exe Pro jectTemplateConsole exe Query lient exe Query lient vshost exe QuerytlientExample cfy QueryServer exe StoreClient exe StoreClient vshost exe Storeserver exe StructuredRe portExtractor exe StructuredHe portExtractor vshost exe StudyGenerator exe StudyGenerator vshost exe StudyGeneratorExanple cfg VerificationGlient exe 544 Verificationberver exe 1 5044 227 bytes 1 584 227 bytes 1 685 758 6033 72H bytes free Example output produced by running the PowerTools console command list 2015 Laurel Bridge Software Inc All Rights Reserved v1 0 34 4 GUI Applications 41 Common Components There are several components that are common to many or all of the PowerTools GUI applications Learning to use these components will make interacting with the PowerTools GUI interface much easier 4 1 1 Menu Bar The Menu Bar may vary slightly between GUI applications however the following commands are present in almost every PowerTools application File Tools Help e File gt Exit Exits the application e Tools gt Options Displays options for the application Many applications have settings to specify o Logging o Filtering e Tools gt Revert To Factory Settings Reverts all conf
33. E 7237 MAC 90 B1 1C 9 B9 8E User amp X Site My Company dt Mary Smith Email mary smith mycompany com amp Host Name Server 5 Maintenance amp Contact IT Manager Email it manager amp mycompany com Phone 3025551234 Note that if PowerTools does not have internet access you will need the 16 digit Activation Request Code ARC from the Manual Product Activation see above On that form enter your 16 digit Product Serial Number and the 16 digit Activation Request Code After completing the steps on the web activation form you can download a fully activated PowerTools license Once downloaded use the Install License button on the About dialog to install your activated license If you only have a MAC address you will need a valid login to www laurelbridge com to proceed For assistance with this process please send email to support laurelbridge com 3 3 PowerTools Launcher The PowerTools Launcher can be found in the start menu and provides access to all of the PowerTools GUI applications Each application has a brief description available by selecting the application in the list Double clicking an application or selecting it in the list and clicking Launch will begin execution of that application All PowerTools applications except for the Launcher can have multiple copies running at once Information about PowerTools and access to license information can be accessed by clicking the About PowerTools butto
34. Enable Filtering enables disables filtering for the application s input output DICOM messages o Edit Filters opens the Filter Editor Dialog to edit the filters for the application e OK exits the Options Dialog and saves any changes e Cancel exits the Options Dialog without saving 4 1 3 Filter Editor Dialog The Filter Editor Dialog provides the ability to create filters which will modify DICOM communication or DICOM files on disk Each filter 1s chained together to the next one and all are executed in order on a DICOM data set a collection of DICOM elements These elements comprise the header of each DICOM image filtered currently pixel data cannot be filtered PowerTools User Manual 2015 Laurel Bridge Software Inc All Rights Reserved v1 0 34 Filter Editor Type Inbound Filters Import Export Conditions Match All O Match Any condition case execute find replace insert overwrite h l Use Original Attributes Sequence SG I Find Replace Patient s Name Cl Use Reg Exp 1 Ignore Case m Jes Cancel Key components in the Filter Editor Dialog include e Type changes the filters that are being edited for example Inbound Filters in the image above represents all incoming DICOM communication to the application e Import imports a filter configuration from disk allows configurations to be shared between PowerTools utilities e Export exports a fil
35. Encoded Transfer Syntax Only e Continue Sending On Error if checked and an error occurs during the transmission of a single DICOM image then the images that have not yet been sent will still be attempted e Fail On Rejected Presentation Context if checked and presentation context negotiation 1s unsuccessful for an image then the store attempt will fail e Use Separate Associations For Each Image if checked then each image will be sent using a separate association By default all images are sent together in a single association This option could be useful for load testing of a server e Delay each store by optionally define a delay to be used between each image being sent from 0 to 99 999 seconds e Hide Report On Successful Send If all images are sent successful and this 1s checked then the status report shown at the conclusion of the send will not be displayed e Context Mode the mode with which to negotiate presentation contexts using the Desired Client Transfer Syntaxes For Presentation Context Negotiation List Oo As Encoded Transfer Syntax Only sends all images in their current transfer syntax If the SCP will not accept an image s transfer syntax then that image will not be sent O As Encoded Else SCP Preferred Transfer Syntax attempts As Encoded Transfer Syntax Only and if that fails then the image will be sent in whatever transfer syntax the SCP prefers O As Encoded Else SCU Preferred Transfer Syntax
36. KNEE RIGHT QUAD KNEE LG JOINT HF1006 94 MINER STEPHEN r gt T E Hoe m W ett The context menu for each type of element is shown and described below Add Element Add Sequence Item Edit Element Edit Sequence Element Add Element Delete Delete Delete Expand All Expand All Expand All Collapse All Collapse All Collapse All DICOM Element DICOM Sequence Element Sequence Item e Add Element adds a new element to the DICOM data set standard element or sequence element Edit Element edits the currently selected element sequence items cannot be edited Delete deletes the currently selected element s or item s Add Sequence Item adds an item to the selected sequence element Edit Sequence Element edits the selected sequence element Expand All expands all sequences for complete viewing Collapse All collapses all sequences for compact viewing The DICOM Element Editor provides an interface for editing an individual item in a DICOM data set Its fields are described below DICOM Element Editor Tag Code 0010 0010 Tag Name Patient s Name VR Value s DOE JOHN Validate PowerTools User Manual 2015 Laurel Bridge Software Inc All Rights Reserved v1 0 34 44 e Tag Code the group element hexadecimal value describing the DICOM element private tags may be specified by typing them in directly e Tag Name the name of the DICOM element
37. Laurel Bridge PowerTools User Manual LAUREL BRIDGE Providing DICOM Connectivity for the Medical Community Laurel Bridge Software Inc 302 453 0222 www laurelbridge com Document Version 1 0 34 Document Number LBDC 000062 010034 Last Saved 11 23 2015 11 55 00 AM PowerTools User Manual 2015 Laurel Bridge Software Inc All Rights Reserved v1 0 34 Contents 1 Porto hasene 1 LE EE EEE EEE ee 1 2 NNN NR EU m m 1 2 1 Graphical User Interface GUI Applications rrrrrrrnnnnnnnnrrrnnrnnnnnnnrrrnnnrnnnnnnnerrrnnnnnnnnensrnnnrnnnnneeesernnnnnn 1 12 2 Command Line ApplicationsS rronnrnnnnnrrnnnnnrrnnnnnrnrnnnrrnrnnnrnnnnnernnnnssennnnesnnnnnernnnnesrnnnnssnnnnnesnnnnssennnnssennn 2 1 5 Important FeatUF JOE 2 2 MENN 4 2 EE duelli cM 4 OEP 4 2 GL autas ETT 5 ONE RESET mmm 5 3 2 Activating a License over the Internet ccccsssccsosscscssssssesccusseccoussscueussscneoussestoussscneussscneousrense 5 Bede 018 Ke 9 SET 0 EE 6 PT 7 UT UON aoni E E E E 9 Adl Common 101019 1 Rm 9 4 1 1 MENU Ba EE E E E se cecanessuctonsetaateanueeccosecee 9 4 1 2 OU OMS Dal OP esia Ea E ur 10 4 1 3 MND 10 4 1 4 ee 15 4 1 5 Server Routing IMON ENO e Tm 16 4 1 6 Transfer Syntaxes for Presentation Context Negotiation ss sssssrerssssrersssrrresssreresssreressereresseree 16 4 1 7 Application Window Renaming rrronnrrnnnnnrrnnnnnrnrnnnrrnrnnnrnnnnnernvnnnsennnnesennn
38. More details about using the Filter Editor Dialog are found in section 4 1 3 above 6 2 3 Format of Query Configuration File The query configuration file described above has a simple name value pair format For reference there are a number of example configuration files cfg in the PowerTools installation directory Each line of the file contains a DICOM group and element number separated by a comma followed by an equals sign and an optional expected value For example 00098 0020 20070101 0010 0010 Match line The first line 1s a match line and contains the group and element numbers for a Study Date tag When used in a query this line will match a Study Date tag with the specific date defined January 1 2007 Result line The second line is a result line and contains the group and element numbers for a Patient s Name tag Because no value is specified this line will match any Patient s Name Results returned When all match lines in a query configuration file match those in a dataset on the Query Server that dataset is deemed a match The results returned by a query will consist of all tags and values that match any of the match lines or result lines In the above example if a dataset 1s found with the matching Study Date the results returns will consist of the Study Date and Patient s Name PowerTools User Manual 2015 Laurel Bridge Software Inc All Rights Reserved v1 0 34 64 6 3 MWL Server The MWL Serv
39. al data dictionary manager where the user is presented with a four choices of the Type of dictionary to load e None do not load any external data dictionary e Blank create an empty text file and load it as the external data dictionary e Built in DICONDE Dictionary load a standard DICONDE data dictionary e User selected Dictionary enable the selection of a data dictionary file select External Data Dictionary 2 Type Mone ee Mone Blank File Built in DICONDE Dictionary User Selected Dictionary Reset Show Folder Cancel When the User selected Dictionary option is selected the file browser is activated so the user can select a data dictionary File PowerTools User Manual 2015 Laurel Bridge Software Inc All Rights Reserved v1 0 34 Select External Data Dictionary Type User Selected Dictionary User Selected Dictionary File C temp my_ext_data_dictionary Reset Show Folder OK Cancel Buttons on the Select External Data Dictionary dialog do the following when clicked e Reset sets the selected Type to None and clears the File entry field e Show Folder opens the default application folder containing the current and any backup external data dictionaries e OK saves the current options for external data dictionary If the data dictionary in use was changed a backup copy of the previous data dictionary is created in the same directory e Cancel cancels any
40. anual 2015 Laurel Bridge Software Inc All Rights Reserved v1 0 34 38 Using Wildcards Wildcards provide a simplified version of regular expressions Add one or more wildcard characters to provide the following search capabilities nis matches beginning of field amp matches end of field E matches 0 or more character matches a single character Examples Study matches all fields that start with Study UIDS matches all fields that end with UID a n matches all fields that contain an a followed by any number of characters eventually followed by an n Uu D matches all fields that contain a VU followed by any single character followed by a D The navigation view on the left side of the UI displays the four levels of the imported instances patient study series instance The displayed values for each level are Patient ID Study Instance UID Series Instance UID and SOP Instance UID All studies having the same Patient ID will be displayed underneath that entry All series having the same Study Instance UID will be displayed underneath that entry All instances having the same Series Instance UID will be displayed underneath that entry DICOM File Editor Laurel Bridge Software mr knee dcm o File Tools Help A mr knee dcm x Hex Image Patient PIKR752962 1 study FE 9 Study 2 16 7602350 10 1 series 0002 0000 Group Length i m giorni mii 0002 0001 File Meta Information Version O
41. atient s Birth Time TM 1 0010 0040 Patient s Sex cS il 0010 0050 Patient s Insurance Plan Code Sequence SO 1 0010 0101 Patient s Primary Language Code Sequence SO 1 0010 0102 Patient s Primary Language Modifier Code Sequence SO 1 0010 1000 Other Patient IDs IO 1n 0010 1001 Other Patient Names PN 1mn 0010 1002 Other Patient IDs Sequence S0 1 0010 1005 Patient s Birth Name PN 1 0010 1010 Patient s Age AS 1 0010 1020 Patient s Size D 1 E 80 Results Found E PowerTools User Manual 2015 Laurel Bridge Software Inc All Rights Reserved v1 0 34 45 There are four different dictionaries available for searching SOP Classes Transfer Syntaxes Attribute Tags and VR Names Once one of these dictionaries has been selected by clicking on one of the four tabs relevant columns are displayed and are searchable by typing into the Filter text box Search results consist of only the rows in the table of values that match the text typed into the Find text box subject to one of four matching criteria Contains the find text is contained anywhere in a field Starts With the find text 1s found at the beginning of a field Ends With the find text 1s found at the end of a field Wildcards the find text can contain wildcards that enable a simplified regular expression style matching When Wildcards mode is selected a help icon is enabled Wildcards When the help icon is clicked a Using Wildcards instruction dialog
42. ation display components PowerTools User Manual 2015 Laurel Bridge Software Inc All Rights Reserved v1 0 34 49 e Message Template A user editable area that contains the template to be used for sending an HL7 message In the Tools menu there is support for loading an example message template and for clearing the template window e Message Sent Response A logging window that displays messages sent and responses received e Macro Name amp Replace Value Table a table of Macro Replacement mapping rules Each occurrence of an item in the Macro Name column will be replaced in the message before it is sent with the corresponding Replace Value For more details on using Macro Replacement see below e Verbose Window when checked messages are logged in the Message Sent Response window e Messages Sent a count of the number of messages that have been sent e Clear when clicked the Message Sent Response window and Message Sent count are cleared e Delay sec a delay in seconds to be inserted between each successive message send e Repeat Count a count of the number of times the message template should be used to send a message It is a count of the number of messages to be sent e Receiver Host host name of the HL7 Receiver server e Receiver Port port number that the HL7 Receiver server is listening on e Application Name configurable name of an application that is sending the HL7 messa
43. be one capturing group Then the outputs would look like this Tag X Output Pattern 0010 0010 2 1 0010 0020 1 1 This results in the first pattern 1 1 from the first input tag 1 1 being put into the second output tag 0010 0020 and the first pattern 2 1 from the second input tag 2 1 being put into the first output tag 0010 0010 In this case the first pattern is also the entire value So if you started with John Doe and 1 2 3 4 5 in Name and ID respectively your result would be a Patient ID of John Doe and a Patient s Name of 1 2 3 4 5 2 Split one tag into two tags Take the Accession Number 0008 0050 and keep only the first 10 characters in it and put the rest of it into the Requested Procedure ID 0040 1001 In this case the regex for the input pattern has to specify how to split the Accession Number lag Input Pattern 0008 0050 10 This regex means the first 10 characters will be the first capturing group and everything else will be the second capturing group Then the outputs would look like this Tag X Output Pattern 0080 0050 1 1 0040 1001 1 2 PowerTools User Manual 2015 Laurel Bridge Software Inc All Rights Reserved v1 0 34 53 This means that the first capturing group the first 10 characters will go into the Accession Number everything else from the Accession Number will go into the Requested Procedure ID If the initial Accession Numb
44. cement value o TransformUID For a UI element the existing UID will be transformed in a consistent manner to allow for repeatability For instance this option is typically selected for SOP Instance UIDs to allow a given UID to map to the same new UID across multiple instances of the De Identify Filter Action o Replace Replace the current DICOM attribute value with an appropriate replacement value based on the attribute s VR The replacement value is predetermined and is not configurable o UserDefined Replace the current attribute value with the given replacement string defined in the Value column o Default Replace the current DICOM attribute value with a user specified value For example specifying the default of M for Patient s Sex will set all instances of Patient s Sex to M by default o Delete Specifying this option will remove the given attribute from the de identified dataset If Delete is selected for a given attribute and the attribute is present in a sequence SQ that sequence will be removed from the de identified dataset Value If UserDefined is selected as a replacement value action the string specified in the Value column will be used as a replacement value for the given attribute This value will appear as 1s Care should be taken when entering a value for non standard string VR types CS for instance Delete Press the delete button in order to remove the given attribu
45. dicating the sequence There may be multiple sequences and sequence IDs as part of one tag Examples are shown below Simple tag 0010 0010 Tag within sequence 0080 0100 0008 0060 Tag within specific sequence item 0080 0100 40 0008 0060 Tag within nested sequence with sequence items 0080 0100 41 0080 0100 40 0008 0060 If no item number is specified the first item 0 is assumed Specify the last element in a sequence by L upper case is important if the number of sequence items is unknown PowerTools User Manual 2015 Laurel Bridge Software Inc All Rights Reserved v1 0 34 54 Specify the next item in the sequence via N again case is important to append to the sequence For example 0080 0100 4L 0010 0010 4N 0008 0060 Please notice that e The sequence IDs e g 1 and the tag value pairs for the sequences are all separated by periods e The tags for the sequences are simple group element pairs themselves 52 De Identify Filter Action oe Xe Dicom Attribute Tags To Anonymize Attribute Tag Name Tag Action Accession Number SH 0008 0050 Hash A 18 4000 Adora Acquisition Date Time Acquisition Device Processing Description T JHE ii 1 2 1 E TH LB RB lin S a E Il j 25 i DT easton Tme mm coo 2160 Wmwghae DA L LEL id it Prk Private Tag Action Do Nothing Pixel Regions to nonymize Iv Anonymize Pixel Data v Enable Re
46. e As menu Save multi frame Use Save Image As to image as plain option bmp gif jpeg pbm image as GIF save as Animated GIF image pgm png ppm tiff animation Copy image Right click on Header Hex or Double click on path to Image tab or image panel element in Header clipboard select Copy File Path to view Clipboard Save image Right click on a tab or image Type Ctrl F or select shortcut panel select Save Image As Tools gt Find in Open DICOM Dataset Open Right click on a tab or image Find and Highlight Open Find dialog click containing panel select Show in Folder Find All directory Load DICONDE Click upper right DICOM Find with Microsoft Check Use wildcards or ext indicator if present or Manage style wildcards in Find dialog dictionary button on Options dialog Show names Check Show names for well Change number of Edit value on Options for well known known UIDs on Options dialog Recent Files shown dialog UIDs otudy Generator Store studies in parallel max 32 Demo multiple Run study generators Quickly change Use Store Server Profiles target store define multiple easily select server desired server Delay between stores Change delay in Options dialog Click on Background Image or Browse button Add Columns and Rows tags in Tools menu modify values Override image dimensions PowerTools User Manual Use separate association Demo image overlays Max image generation limit
47. eceiver Host localhost REDERICK P DR IIIIII I1 IV1007 7ADTAUL LL LLL EL LLL ELE LILLLLLLLLI E 2000082011001111111VI Receiver Port 2575 ORC NW ORDARG MESA ORDPLC B100Z MESA ORDFILI SC 1 once S D 200008161510 ROSEWOOD RANDOLPH 7101 E STRADA JAIME P DR 314 555 Application Name 1212 200008161510 922229 10 IHE RAD IHE CODE 231 Sending Faciity OBR 1 A100Z MESA ORDPLC B100Z MESA ORDFIL P1 Proce dure 1 ERL MESA X1 _A1 SP Action Item X1 Al DSS MESA IIIIIIIxxx Radiology R 7101 ES TRADA JAIME P DR XR999399 RP123456 5P9123456 MRIII1 Wait For Ack once S WALK l lll lll IALT IRP XI RP Action Item RP X17DSS MESA ZDS 1 2 1 100 Application DICOM Ack Timeout sec o i _ New Connection Per Message ConnectionInfo ID 32365e5a d21c 44a4 ac61 549dff80723d 127 0 0 1 54665 gt 127 0 0 1 2575 Secure False Sent message at 12 19 36 148 Enable SSL MSH X amp MESA OF XYZ RADIOLOGY MESA IM XYZ IMAGE M ANAGER ORM OO01 p 100112 P 2 3 1111111 II em PID PATIDO0001 PATFIRSTNAME PATLASTNAME 19450804 M WH 82 0 JORIE BLVD CHICAGO IL 60523 l 111120 98 4000 LL LEE E EET ELT L EL TF TL TG JG 1 1 Ol Allow Self Signed Certificates BV1 EIEDIIII1234 WEAVER TIMOTHY P DR S5101 NELL F REDERICK P DR IIIIIIIIIV10O ADT1 I ELE EL LLL LLL ELE ILILILILIL 200008201100 lllIIIIVI Vert Wind ORC NW ORDARG MESA ORDPLC B100Z MESA ORDFIL SC 1 once S 200008161510 ROSEWOO
48. eessseessseessreessscessseessreessseessseessreessreessreessseessseesssee 55 332 2 Miscellaneous SebtlligSus duit e teu tS u Ud t Ete ad rate to Gus nee ote bete ueteres oie 56 3 2 9 PIxeL Resions to Anonymi a m eco unten oboe both oo orte te brit oti Ie acabe des OBon In tabo us ep nba E bottoni a 56 5 2 4 NEVA NON 57 5 25 suled eris red 57 5 2 6 Additional NE 57 9 9 FN HE NNN 58 5 3 1 Adaitional NOUS ee 59 6 Console Allen 60 on ENN 60 02 Ober UNN 61 6 2 1 Ve ENN 61 6 2 2 Creating Sa Fler Elle saec ees ela t adeat STP 62 6 2 3 Formator Query Configuration FIe sv 63 Oos MN 64 T PONG TINN catena fon sitet itera acoso cune osa beta ca attesa fume tctbe e eds 65 7 1 Combined GUI and Console Applications rrrrrnnrrrnnnnnrrnnnnnernnnnnnrnnnnnnrrnnnnnernnnnnnennrnnnennnnnneennnnneeene 65 PowerTools User Manual 2015 Laurel Bridge Software Inc All Rights Reserved v1 0 34 TL GUO APG HS 65 bos Console He 65 8 PowerTools Quick Reference rrrnrnrnrnnnnnnnnnnnnnnrnvnnnenenenenenensnsnsnsnsnnnnnnnnnnnenennenesenenenenenenenenene 66 PowerTools User Manual 2015 Laurel Bridge Software Inc All Rights Reserved v1 0 34 1 PowerTools Introduction 1 1 Overview Laurel Bridge PowerTools is a software only collection of stand alone Windows applications designed for the diagnosis testing and or repair of DICOM communications for the viewing repair or creation of DICOM data sets and their contents and for commu
49. efore timing out the query times out after no response has been received for the number of seconds specified Settings Query Timeout 5 Limit Max Query Results e Limit Max Query Results if checked then the maximum number of queries returned is limited to the value specified Options Logging Pee eee eee eee re View Log Log Level View Log Directory Dicom Terse hl Filtering Enable Filtering Edit Filters Settings Query Timeout s 50 Limit Max Query Results 100 OK Cancel The Options dialog in the Query Client provides Logging and Filtering support as well as a convenient interface to configure Query Timeout and to Limit Max Query Results returned PowerTools User Manual 2015 Laurel Bridge Software Inc All Rights Reserved v1 0 34 09 4 2 2 Store Client The Store Client is used to perform DICOM image store operations and has both console and GUI versions Once DICOM images have been selected and the Send button is clicked images are sent to the selected DICOM store server Sending can be canceled at any time by clicking the Cancel button Upon completion an optional status report of the completed store operation can be viewed Advanced settings in Store Client are described below Continue Sending On Error v Fail On Rejected Presentation Context w Use Separate Association For Each Image Delay each store by 00 000 seconds v Hide Report On Successful Send Context Mode As
50. er is distributed with a small worklist database of files This provides a quick start to exploring the use of MWL Queries such as using the GUI version of the Query Client or the console MWL Client To use the included worklist database contained in the directory named worklist that is found inside the PowerTools installation directory open a PowerTools Console from either the PowerTools Launcher or the Windows Start menu and start the MWL Server by typing this MWLServer 11113 worklist To query this worklist start the Query Client application enter a Server Port to match the port in the command above 111113 select a Type amp Method of MWL and using the Use Default Tags drop down button select Minimal MWL Tags Query Type amp Method MWL Jl telationa MWL Query Move AE Title Minimal MWL Tags Root Study Standard MWL Tags Study Extended MWL Tags uerying Then click the MWL Query button and observe the output Ai Query Client Laurel Bridge Software EE File Tools Help Client AE Title SCU Result Scheduled Station AE Title Scheduled Procedure Step Start Date Modality Study Instance UID Study Date AccessionNumber Patient s Name Patient ID Client IP Address Default lt gt 1 DROC NUMBER 1 20020625 NM 55556666 20100624 111 Simpson Homer 112233 2 DROC NUMBER 1 20020625 CT 44445555 20110601 222 Simpson Bart 112244 3 DROC NUMBER 1 20020625 CT 11112222 20090808 555 Simpson Marge 112277 Server AE Title SCP 4
51. er of messages that have been received e Start when clicked starts the server so it is listening for connections and is ready to receive incoming messages e Stop when clicked stops the server e Clear when clicked clears the message window HL Receiver Laurel Bridge Software ied File Tools Help I100112 PI2 3 10II1I L1 VI PID PATIDOODO1 PATFIRSTNAME PATLASTNAME 13450804 M WH B2 0 2575 4 JORIE BLVD CHICAGO IL 60523 IIII20 38 4000 LL ELE LEE LEE EE E EET EE I PV1 EIEDIIII1234 WEAVER TIMOTHY P DBR 5101 NELL F BEDEBICE P DRIIIIILL I 111 Iv1lOO777ADTILpEEL LEE E ELE EL TL E BEETTETTTRTT zo noos201100 III IL IVI ORC NW ORDARG MESA ORDPLC B100Z MESA_ORDFIL SC 117 once 8S 200008161510 ROSEWOOD RANDOLPH 7101 E STRADA JAIME P DR 314 555 1212 200008161510 922229 10 IHE RAD IHE CODE 231 OBRI 1 A100Z7MESA ORDPLC B100Z MESA ORDFIL Pl Proce dure 1 ERL MESA X1 A1 75P Action Item X1 A1 DSS MESAI III I LI I ae Radiology R 7101 ES TRADA JAIME P DR XR999999 RP123456 SP5123456 MRIII1 7once 7 S WALKIIIII II ILL IAILILIRP X7RP Action Item BP X1 7D55 MESA ZDS 1 2 1 7100 7Application DICOM Verbose Window stop Messages Received 1 Clear 4 5 2 HL7 Sender The HL Sender is a client that communicates with an HL7 Receiver server sending messages and receiving optional ACK responses The user interface provides the following configurable options and inform
52. er was ABCDEF 1234567890 then you would have ABCDEF1234 as the Accession Number and 567890 as the Requested Procedure ID Note that the output tag does not necessarily have to be parsed as an input 3 Combine two tags Take parts of the Accession Number and parts of the Requested Procedure ID and mix and match them lag Input Pattern 0008 0050 110 0040 1001 4 6 C 4 These regular expressions mean to split the first tag into two capturing groups the first one having 10 characters and the second one having whatever is left and to split the second tag into two capturing groups the first one having 6 characters and the second one having the following 4 characters Then the outputs might look like this Tag X Output Pattern 0080 0050 1 1 2 2 12 1 0040 1001 2 1 11 2 If the initial Accession Number was ABCDEF1234567890 and the initial Requested Procedure ID was 1 2 3 4 5 6 7 8 9 0 then the resulting Accession Number would be ABCDEF1234 4 5 1 2 3 the resulting Requested Procedure ID would be 1 2 3 567890 Note that the patterns can be used multiple times and also combined with plain text Working with DICOM sequences A sequence may be entered as a tag by appending it to a numeric tag the traditional group element pair with a period You may also indicate an item in the sequence with and the sequence item ID followed by the tag in
53. es the specified character sequence from the beginning and or end of a DICOM element s value if present In this example the character sequence abc is removed from the beginning of the Patient s Name value Note that multiple instances of the character sequence could be removed For example if the Patient s Name DICOM element contains the value abcabcSteve the resulting value will be Steve Patients Name Chars A Left CI Right 4 1 4 Client Routing Information All client GUI applications have the same interface for specifying routing information Client AE Title SCU Server E Title SCP Client IP Address Default v Server Host localhost Client Port v Allow Any Server Port 11112 ss Verify e Client AE Title the Application Entity title for the running application client e Client IP Address the IP address to use on the local machine when sending data PowerTools User Manual 2015 Laurel Bridge Software Inc All Rights Reserved v1 0 34 Client Port the port to use on the local machine when sending data select Allow Any to choose the next available port Server AE Title the Application Entity title of the server machine to which to connect Server Host the host name or IP address of the machine to which to connect Server Port the port number on the server machine to which to connect Verify click this button to send both an ICMP Ping and a DICOM C Echo test
54. f sequence elements Pixel data can also be viewed DICOM Filter filters one or more DICOM images on disk Dictionary Finder displays data from the DICOM data dictionary HL7 Receiver receives HL7 messages from an HL7 client or sender HL7 Sender sends HL7 messages to an HL7 server or receiver PDF to DICOM create DICOM Encapsulated PDFs from existing PDF files and write them to files or store them to a PACS e Query Client queries a query SCP or PACS for DICOM images and can move DICOM images from the server to another location e Store Client stores DICOM images from disk to a store SCP e Store Server receives C Store DICOM images from a store SCU PowerTools User Manual 2015 Laurel Bridge Software Inc All Rights Reserved v1 0 34 e Structured Report Extractor parses structured reports and creates mapping files for use with Laurel Bridge Software Compass and third party systems e Study Generator generates DICOM images and stores them to a store SCP e Verification Client verification SCU to send C Echo requests e Verification Server verification SCP to receive C Echo 1 2 2 Command Line Applications e DICOMDIR Creator creates a DICOMDIR file from a directory of DICOM images on disk 1 e DICOM media creator DICOM File Editor dumps the contents of a DICOM file and edits a single DICOM file DICOM Filter filters one or more DICOM images on disk DICOM to PDF
55. from disk This functionality can also be performed by dragging a DICOM file from Windows Explorer into the main view of the DICOM File Editor o Open Folder opens a folder of DICOM files from disk This functionality can also be performed by dragging a folder of DICOM files from Windows Explorer into the main view of the DICOM File Editor o Recent Files provides a convenient list of recently opened files o Import From LBS CFGGroup similar to Open but uses a Laurel Bridge data file instead of a DICOM file o Export To gt LBS CFGGroup saves the currently open DICOM data set as a Laurel Bridge data file o Export To gt Text Document dumps the currently open DICOM data set to a text file in text format o Save saves the current DICOM data set to a file o Save As saves the current DICOM data set to a file specifying the file name and transfer syntax in which to save the image o Save Image As saves the currently displayed image frame on the Image panel as a regular image BMP GIF JPEG PBM PGM PNG PPM TIFF For multi frame images the current frame will be saved to one of these formats Additionally for multi frame images only the complete multi frame image can be saved as an Animated GIF at a 10 fps rate o Save Header As Text saves the header of the current DICOM data set as a plain text file specifying the file name of the saved file O Print Preview shows a preview
56. ges e Sending Facility configurable name of the facility sending the HL7 messages e Wait for Ack when checked causes the application to wait to receive an acknowledgement ACK message from the HL7 Receiver before sending the next message e Ack Timeout sec how long to wait for an ACK to be received before timing out and continuing with the next message e New Connection Per Message when checked sends each message on a new connection e Enable SSL when checked enables an SSL connection with an HL7 Receiver e Ignore Certificate Name Mismatch Errors when checked allows name mismatches in the SSL certificate to be ignored e Allow Self Signed Certificates when checked allows SSL certificates to be self signed e Send when clicked message begin to be sent e Cancel when clicked cancels message sending that is in progress PowerTools User Manual 2015 Laurel Bridge Software Inc All Rights Reserved v1 0 34 50 V HL7 Sender Laurel Bridge Software TRA File Tools Help Message Template Macro Name Replace Value ois MSH X amp MESA OF XYZ RADIOLOGY MESA IM XYZ IMAGE M ANAGER ORM O01 Delay sec 100112 PI2 3 1111111I 11 LN x PIDI PATIDOO001 PATFIRSTNAME PATLASTNAME 19450804 M WH 82 0 JORIE Repeat count oi BLVD CHICAGO IL 60523 111120 98 40001 LL LLL EL LLL ELLE LL L 1 1 PV1 EIEDI 11234 WEAVER TIMOTHY P DR S101 NELL F R
57. iguration settings for the application back to their original defaults e Help gt User Manu Opens the PDF user manual document for viewing e Help gt Support Request Opens the Send Support Request dialog so a user can send a request for support directly from the running application e Help gt Feedback Opens the Send Feedback dialog so a user can send feedback to Laurel Bridge Software directly from the running application e Help gt About Shows the About dialog for PowerTools information and for license management including support for license installation and activation Help Je User Manual ty Support Request Feedback amp About DICOM File Editor Help menu options PowerTools User Manual 2015 Laurel Bridge Software Inc All Rights Reserved v1 0 34 4 1 2 Options Dialog The Options Dialog provides two common features shared by most of the GUI applications logging and filtering Options View Loq Log Level View Log Directory Dicom Terse Filtering Enable Filtering Edit Filters OK Cancel e Logging o Enable Logging enables disables logging for the application o Log Level selects the amount intensity of the logging useful for debugging o View Log click to open the current log for the application o View Log Directory click to open the directory where the logs are stored e Filtering only present in the Options Dialog for client and server applications o
58. ill be logged to the console PATH1 PATH2 PATH3 a list of paths separated by spaces referencing either DICOM files or directories containing DICOM files to recursively filter using the FILTER CEG FILE filter configuration PowerTools User Manual 2015 Laurel Bridge Software Inc All Rights Reserved v1 0 34 61 The detailed usage statement for each application provides user guidance for most tasks Descriptions of some of the more common complex uses are provided here for selected applications 6 2 Query Client 6 2 1 Query example As described in the application s command line help the Query Client can make use of user defined query configuration and input filters files For example 1f a user desired to query a server for datasets with a specific study date and filter one or more tags the following steps can be used 1 Create a query configuration file containing the tag or tags to be queried for In this example create a file called query txt that contains the following lines 000870020 001070010 00010 0020 0020 000d 20070101 This queries for datasets that have a Study Date 0008 0020 of January 1 2007 and will return values of the Study Date Patient s Name 0010 0010 Patient ID 0010 0020 and Study Instance UID 0020 000d tags Note that the Query Retrieve level should NOT be put in the query txt file as it is set using a command line switch default level is STUDY For a description
59. ing those values plus Accession Number and Referring Physician looks like this MwlClient other params q 0008 0050 g 0008 0090 q 0010 0010 Simpson Instructions for using a configuration file to perform queries are contained in the example configuration file MwiClientExample cfg found in the PowerTools installation directory The GUI version of the Query Client supports top level Modality Worklist queries with future enhancements planned 4 2 5 Study Generator The Study Generator uses customizable Patient Name Date of Birth Sex Modality and Study Date attributes to generate and store one or more DICOM images to a specified Store Server profile comprised of Host Port Called AE and Calling AE The application supports defining up to 32 of these Store Server profiles to simplify repeated testing on multiple destinations Any number of additional DICOM tags Extra Tags can be specified and the user can specify the Number of Studies Series per Study Images per Series Image Size and whether or not to Use Separate Association per Study Series or Image Clicking on the Generate button starts the store Job which can be canceled at any time by clicking the Cancel button If the Store Studies in Parallel option 1s checked the Study Generator will attempt to concurrently store each of the requested Number of Studies up to a limit determined by the Windows operating system There also may be an even lower limit for the maximum nu
60. ion Context Negotiation Some client and server applications provide the ability to select what transfer syntaxes should be included in presentation context negotiation This ability allows a client application to force DICOM communication to a server to use a specific transfer syntax or to give preference to certain transfer syntaxes It also allows a server to accept only certain transfer syntaxes from a client or to give preference to certain transfer syntaxes PowerTools User Manual 2015 Laurel Bridge Software Inc All Rights Reserved v1 0 34 17 JPEG 2000 Lossless Only 1 2 840 10008 1 2 4 90 UID Name 1 2 840 10008 1 2 1 Explicit VR Little Endian 1 2 840 10008 1 2 Implicit VR Little Endian 1 2 840 10008 1 2 2 Explicit VR Big Endian 1 2 840 10008 1 2 4 70 JPEG Lossless Non Hierarchical First Order Pre 1 2 840 10008 1 2 4 91 JPEG 2000 1 2 840 10008 1 2 4 57 JPEG Lossless Non Hierarchical Process 14 1 2 840 10008 1 2 4 50 JPEG Baseline Process 1 All supported transfer syntaxes are initially included in the drop down box If the add button is clicked then the transfer syntax selected 1n the drop down box will be moved to the list below Transfer syntaxes in the list can be removed and moved up or down in priority The transfer syntaxes at the top of the list will be given greater priority when negotiating presentation contexts and the transfer syntaxes at the bottom of the list will be given lower priority 4 1
61. lect External Data Dictionary section 4 1 8 dialog pops up enabling selection and management of external data dictionaries e Show names for well known UIDs causes the names of any well known UIDs to be displayed in the header view tab rather than the UID strings themselves The original UID will be displayed in a tooltip when the name 1s hovered over with the mouse e Items shown in Recent Files List determines how many recently opened files will be listed in the Recent Files menu item PowerTools User Manual 2015 Laurel Bridge Software Inc All Rights Reserved v1 0 34 2075 The Find Dialog in the DICOM File Editor provides searching within the open data set The Find what field maintains a list of recently used search term Find what Match case Match whole word Find Use wildcards i Direction Down Find Next Find All Cancel Clicking Find Next will search in the selected search Direction Up or Down while clicking Find All will highlight all matching elements in the data set Selecting Match whole word will limit search results to matches that have whitespace or are at the start or end of a field rather than an arbitrary partial match Selecting Match case will make the search case sensitive DICOM File Editor Laurel Bridge Software mr knee dcm File Tools Help A Patient PIKR 752962 i study Study 2 16 7602350 10 1 series Listing 1 patient 1 study 1 series 1 instance from
62. mber of concurrent stores 1 e associations depending on the specific store server being targeted The application attempts to warn the user when these limits are being exceeded although some experimentation may be required An optional Background Image can be selected that will be used as the image content for all generated images When present the background image will contain a visible watermark PowerTools User Manual 2015 Laurel Bridge Software Inc All Rights Reserved v1 0 34 25 indicating that the image is a SAMPLE When not present a solid black background will be used An optional textual Tag Overlay of study information also can be displayed Any image in one of the more command image formats JPEG PNG BMP GIF and TIFF can be used as a Background Image selection of example images for a variety of modalities is in the backgrounds subfolder in the PowerTools installation directory If the Extra Tags for Columns and Rows are loaded after the Background Image is selected their values will be auto sized to the dimensions of the Background Image See below for information on the Load Extra Tags options menu Study Generator Laurel Bridge Software diis File Tools Help Study Information Study Size Patients Name SMITH JOHN Number of Studies 3E Date of Birth 11 09 1960 Series per Study ie Sex M X Images per Series 10 Modality CR Image 5ize KB 256 Browse Clear Study Date 09
63. ment In this example the value in Patient s Weight is moved to the value for Patient s Size even if there is currently a value for Patient s Size Patient s Weight will no longer exist in the DICOM data set Patient s Weight v Patient s Size PowerTools User Manual 2015 Laurel Bridge Software Inc All Rights Reserved v1 0 34 e New UID replaces the UID for the DICOM element listed with a new generated one In this example the value of Device UID will become a newly generated UID If the DICOM element did not exist previously it will be created New UID v Device UID v e Pad pads a DICOM element s value to the desired length with the given character In this example Patient s Name will be changed to be 25 characters long by inserting the character on the Left side of the current value for Patient s Name as many times as necessary to pad to 25 characters long If the current length of the DICOM element selected is already long enough then nothing is changed the value is not cropped Pad y Patient s Name v char Length 25 gt Left Right e Remove removes the given DICOM element from the DICOM data set If the Only If Empty check box is selected then the element will only be removed if its value is empty or zero characters in length In this example Patient ID is removed from the DICOM data set but Only If Empty Remove w Patient ID vw Only If Empty e Trim remov
64. n The user manual you are reading 1s available via the User Manual button PowerTools User Manual 2015 Laurel Bridge Software Inc All Rights Reserved v1 0 34 LAUREL BRIDGE ME Powerloo s DICOMDIR Creator L DICOM File Editor F DICOM Filter F Dictionary Finder HL7 Receiver E HL7 Sender PDF to DICOM E PowerTools Console L A U R E L B R D G E d E e us Dicom SOFTWARE TOOLS AND APPLICATIONS Store Client E store Server E ok Extractor E Study Generator E Verification Client E Verification Server User Manual About PowerTools 3 4 PowerTools Console The PowerTools Console can be found in the start menu and provides access to all of the PowerTools command line console applications The console will launch and set the working directory to the installation folder for PowerTools It will also add the PowerTools installation folder to the Path temporarily for the session Running the predefined PowerTools console command list will display all executables as well as any example configuration files and documentation files see below Running the command dir exe will display all of the executables in the directory Running any of the applications with the h flag will display the command line usage statement for that application Many of the applications are combined GUI and console applications For these combined applications the h flag will display usage information for the GUI version while usi
65. n Server Verification Server can be used to provide a very simple Verification SCP to test a verification SCU Its functionality is present in every server application and will not be described further 4 4 DICOM Data and File Manipulation Applications PowerTools provides DICOM applications which modify one or more DICOM files on disk as well as applications used to manage DICOM data The advanced functionality of these applications is discussed below 4 4 1 DICOMDIR Creator DICOMDIR Creator takes as arguments an Image Directory where DICOM images are located may also be contained in subdirectories and a DICOMDIR File Name usually DICOMDIR The application then creates a directory image hierarchy from the images found in the image directory and creates a DICOMDIR file using the information gathered which is placed in the Image Directory upon completion Results are shown in the Results list PowerTools User Manual 2015 Laurel Bridge Software Inc All Rights Reserved v1 0 34 33 _ DICOMDIR Creator Laurel Bridge Software File Tools Help Image Directory C public test_images DICOMDIR File Name DICOMDIR Greatefupdate Ei Results FilePath ooo Status 000 a C public test_images ct ab 8 dem Successfully Added C public test_images nr knee dcm Successfully Added Also please note the following when creating a DICOMDIR Valid DICOMDIR Directory Structure Information
66. n the first input element is referred to as 11 11 the second match in the first input PowerTools User Manual 2015 Laurel Bridge Software Inc All Rights Reserved v1 0 34 element is 1 2 and the third match in the second input element would be 12 31 and so On The Output Elements specify what parts of the input elements to combine and how to combine them note that the parts can be used multiple times and may also be combined them with plain text Copy copies one DICOM element s value to another DICOM element In this example the value in Patient s Name is copied over the value for Patient s Birth Name Patient s Name vw Patient s Birth Name Execute executes the C code contained in the code file provided This option is provided for special cases where no other actions can perform the needed filtering If this action 1s required please contact Laurel Bridge support Execute v CodeFile C execute_me cs Find Replace checks the value of the DICOM element specified for the given text or regular expression and replaces it with the substitute text or regular expression substitution string In this example the value in Patient s Name 1s checked for instances of the text miner and any such instances are replaced with the text minner 9 Find Replace w Patient s Name v Use Regular Expressions miner minner Insert Overwrite inserts a new DICOM element or
67. nder Launcher Structured Report Extractor Console only Applications DICOM to PDF Indexer MWL Client MWL Server Query Server 2015 Laurel Bridge Software Inc All Rights Reserved v1 0 34 66 8 PowerTools Quick Reference Rename app Appname exe name NewName Run app from Appname exe window See example gui renaming bat console Applications Launch any Launcher Create DICOMDIR from DICOMDIR Creator PowerTools app View edit modify DICOM files Lookup SOP Class amp Transfer Syntax UIDs element names tags VR types Send HL7 messages Send DICOM dataset to server Extract Structure Report data generate PowerScribe 360 mapping file Send echo ping to DICOM device PowerTools User Manual images Filter DICOM files create filters Create encapsulated PDF Query a PACS Find Move MWL Receive DICOM datasets store to disk Generate test datasets send to DICOM server Receive amp respond to echo ping messages 02015 Laurel Bridge Software Inc All Rights Reserved v1 0 34 67 View file or Drag folder onto Dicom File Editor View hex for an Open image select directory of Use Open or Open Folder menu element element select Hex images option view tab Compare Select element in current image View element for Open image select hex elements in select a different image in hex value in Hex view switch to images hierarchy list Header view Save DICOM Use Save Imag
68. ng the h and nogui flags together will display usage information for the console version For GUI only and console only applications the h flag is all that is needed to display usage information PowerTools User Manual 2015 Laurel Bridge Software Inc All Rights Reserved v1 0 34 PowerTools Console x SProgram Files C xB6 5 Laurel Bridge Software PFowerTools gt list isting PowerTools executable example configuration and documentation files Wolume in Volume Serial Humber is Directory 46 26 2815 18 25 2013 A 4 28 2815 A A 2815 A 26 2815 7718 2815 A 28 2815 d2 H7 2815 A 26 2815 A 26 2815 A 8 2815 A 26 2815 46 25 2615 A 20 2615 A 20 2615 47 2 2815 72120815 A 26 2615 41 88 2615 A 26 2615 A 20 2615 A 20 2615 A 20 2615 A 20 2615 46 25 2615 41 8 2615 A 20 2615 A 4 28 2815 16 16 2015 42 28 2815 42 28 2815 d42 21 2815 A 28 2815 d42 14 2815 42 18 2815 A 28 2815 A 26 2815 Total PowerTools User Manual drive C is OG D434 DB5D of GiscoderPowerToolsstrunkbDehug H hak txt 1 211 320 11 6H8 Aer ren 11 6H8 TO ao 11 688 12 888 56 176 11 6H8 41 472 11 648 re Pr 18 432 PH Filets Files Listed 37 Filets H Dirts be hexeditor license txt DicomDirCreator exe DicomDirCreator uzhozst exe DicomFileEditor exe DicomFileEditor vshost exe DicomFilter exe DicomFilter vshost exe DaicomloPdf exe Dict tonaryFinder exe
69. nications testing of basic HL7 messaging It is suitable for use by PACS administrators integration engineers system testers software developers and others who have need of a broad range of DICOM related tools and utilities or need to test HL7 messaging The stand alone PowerTools programs operate as easy to use DICOM server SCP or client SCU applications for communication purposes or operate as other types of applications capable of viewing changing creating converting or fixing a DICOM data set or sending and receiving of HL7 messages Many are provided as both GUI based and command line based applications so the PowerTools utilities may be used as independent applications or scripted into a variety of situations where their capabilities are needed These tools and utilities may be used to transmit receive or edit DICOM medical data or the send and receive HL7 messages However the PowerTools applications are not intended for diagnostic review of images or other medical data 1 2 Included Utilities The core utilities officially included in the PowerTools suite are 1 2 1 Graphical User Interface GUI Applications e PowerTools Launcher provides access to all PowerTools GUI applications e DICOMDIR Creator creates a DICOMDIR file from a directory of DICOM images on disk 1 e DICOM media creator e DICOM File Editor allows the viewing printing and modification of a DICOM file on disk including modification o
70. nsvnnnnssrnnnnesennnnesnnnnssennnnesennn 17 4 1 8 External Data Dictionary Management rrrnonnnnnnnnnrnnnnnrnnnnnnrnnnnnrrnnnnnsnnnnnsrnnnnnsennnnesnnnnnsrnnnnesennnnesnnnnnr 18 qz DICOM Client NT 19 4 2 1 VEN 19 4 2 2 So GENE EE MN EE 23 4 2 3 Mee 106 Eg FRERE E E ee 24 4 2 4 Modality Worklist Client elssseeeesseeeeeeeeeeenn nnne nnn nennen nsn n nnns nnn nns 24 4 2 5 SAC o A 24 4 3 DICOM Server ApplicationS rrrranrrnnnnnnrnnnnnnrrnnnnnernnnnnnnnnnnnnnnnnnnnnnennnnnnennnnnennnnnnnsnnnnnesennnnnsnennnnesene 28 4 3 1 NNN 29 PowerTools User Manual 2015 Laurel Bridge Software Inc All Rights Reserved v1 0 34 4 3 2 NVS 32 4 3 3 Mod lk WOFKIISU SOV ER sisina uadesauetencdus N E N 32 4 3 4 NV CIM CALTON NNN 32 4 4 DICOM Data and File Manipulation Applications rrrrrrnnrrrnnnnnrrnnnnnrrrnnnnnernnnnnernnnnnernnnnnnennnnnneeene 32 4 4 1 DEOMPIR TUE reRS 32 4 4 2 DENE 33 4 4 3 Bee gl ee 44 4 4 4 DICHON TO RABAT ER EE TTE 44 4 4 5 PH rao B L8 I e EU 45 4 4 6 Structured RebDOEUEXEEACEOFE so tor IR tero NU un nod ede eae ee eee 46 ao ME wa ioslle idie a RR TU HP Tr 48 4 5 1 RNA 48 4 5 2 HE7 Sender Rr 48 5 Advanced FN 52 S L Composer Filter ACTION donec aes bh a esi avete sk btc e N 52 52 Desdentie Filter LONG 54 52 DICOM Attribute Tags to Anonymize nssseesssessss
71. oaded will be merged into any data already present on the Mapping File tab The Load button also has a Clear amp Load choice that first clears all data from the Mapping File tab before loading new data PowerTools User Manual 2015 Laurel Bridge Software Inc All Rights Reserved v1 0 34 47 e Extract when clicked the currently selected Structured Report s are parsed and the resulting data 1s added to the Mapping File tab Columns in the Mapping File tab can be sorted in ascending and descending order by clicking on the column heading A context menu appears when any row in the Mapping File tab is right clicked Reset Raw Delete Row Unsort Clear Save Save and View Choices in the context menu perform the following e Reset Row restores the PowerScribe Custom Field value on the currently selected row to the default mapping value which is a simple replacement of all spaces with underscore characters e Delete Row deletes the currently selected row from the Mapping File tab e Unsort removes any sorting of columns that was done displaying the Mapping File tab values in their original order e Clear deletes all rows in the Mapping File tab although it does not affect the Mapping File stored as a file which 1s only changed by saving a new Mapping File using the same file name e Save stores the currently viewed Mapping File data as a text file and creates a backup of the previous file if it has
72. oc 2 c Le E o E a Preamble is Highlighted The DICOM File Preamble and DICOM Prefix are highlighted The File Preamble is a fixed 128 byte field that can be used for Application Profile or implementation specific use If not used all bytes should be set to 00H The DICOM Prefix is four bytes containing the characters DICM that indicates whether or not a file is a DICOM file Le G e RN e Lu E a ec E oca c oc L C ca E a ca I 3 O E 5G e e IC e e e L2 Lr mi E G ES r Ca d Ca Hc E LE cO c BJ LJ ec c Lj 2 I Lu E n ec se e Hae em Hae ua Tem Ba pu Jl ZE 34 00 02 00103 00 I 4 1 E n JE 158 uo JA An 1568 3 THT When present DICOM image data 1s displayed with the built in basic window level image viewer on the image panel PowerTools User Manual 2015 Laurel Bridge Software Inc All Rights Reserved v1 0 34 42 2 DICOM File Editor Laurel Bridge Software mr knee dcm File Tools Help A mr knee dcm x Hex Image Patient PAT124 1study l l Study 2 16 7602350 10 1 series Series 2 1 29304176 1instance i Instance 10 MR Window 799 Level 432 G Listing 1 patient 1 study 1 series 1 instance from 1 directory Viewing mr knee dcm 133 120 bytes Hovering the mouse over the header hex or image panel tabs will cause the currently displayed DICOM file s complete path
73. ociation Rows can be expanded to show a sequence of cards displayed each with a summary of DICOM header tags and a thumbnail view of the image if any Within each card if an image contains multiple frames the Number of Frames 1s displayed When the thumbnail image is clicked it will be opened in the Dicom File Editor for viewing and editing Store Server Laurel Bridge Software File Tools Help Input Running M Start Time Called AE Title Calling AE Title Calling Presentation Address Image Count Status 10 16 2014 3 57 33 PM SCP SCU 127 0 0 1 59677 1 Completed 10 16 2014 3 57 33 PM SCP SCU 127 0 0 1 59678 1 Completed 10 16 2014 3 57 42 PM SCP SCU 127 0 0 1 59680 Customize a File 00000 1 dcm E File 000002 dcm amp File 000003 dem E File O00C Patient s Name DOE JOHN Patient s Name DOE JOHN Patient s Mame DOE JOHN Patient s Name Patient ID ddd63a93 Patient ID ddd69a93 Patient ID ddd69a93 Patient ID Accession Number AF75694CE3EQ5 Accession Number AF75694CES3EQ5 Accession Number AF75694CE3E05 Accession Number Modality CT Modality CT Modality CT Modality Study Date 20141016 Study Date 20141016 Study Date 20141016 Study Date Image Thumbnail Meer rey Image Thumbnail Messi rey Image Thumbnail Metier Tt Image Thumbnail 4 Client AE Title Scu Allow Any Server AE Title SCP Allow Any Client IP Address 127 0 0 1 Allow Any Server Host Default Client Port 2000 Allow Any Server Port 11
74. of what will be printed if the current DICOM data set 1s printed o Print prints the current DICOM data set to a printer without pixel data PowerTools User Manual 2015 Laurel Bridge Software Inc All Rights Reserved v1 0 34 35 o Close closes the currently open data set if any o Clear clears the list of DICOM data sets in the navigation view o Exit exits DICOM File Editor ptions Ctrl T Find in Open DICOM DataSet Ctrl F Clear Find Highlighting Ctri X Filter Open DICOM DataSet Ctri Shift F Copy Path of Open File to Clipboard Ctrl C Revert To Factory Settings Tools Menu e Tools o Options launches the Options Dialog see below o Find in Open DICOM DataSet launches the Find dialog that enables search operations in the open data set o Clear Find Highlighting clears the highlighting that results from a Find AII operation in the Find dialog o Filter Open DICOM Data Set launches the Filter Editor Dialog and applies any filters to the currently open DICOM data set o Copy Path of Open File to Clipboard copies the complete path of the open DataSet file to the system Clipboard o Revert To Factory Settings in addition to the default reset behavior selecting this will clear the Recent Files list and the list of recent search terms in the Find dialog PowerTools User Manual 2015 Laurel Bridge Software Inc All Rights Reserved v1 0 34 96 The Op
75. on file if this file does not exist its location will used as the configuration file location and default settings will be loaded if not present the default configuration file will be used backup if present and CFG FILE is present then the configuration specified by CFG FILE will be backed up before any upgrade logic is applied recommended nogui run the application in console mode use with h switch to view console mode usage To run this application in console mode run it using the nogui command line switch To view usage for the console version of the DICOM Filter simply append the nogui switch DicomFilter h nogui The resulting output looks like this This application can be used to filter DICOM files on disk Files can be referenced either by an explicit path or by referencing a directory which will be recursively searched for all DICOM files Filtered DICOM files will be written back to their original location so it is recommended to make a backup of all files before filtering To run this application in GUI mode run it without the nogui command line switch Usage DicomPrilter exe FILTER CPG FILE nogux 1 i PATH1 PATH2 PATHS display command line usage FILTER CRG FILE the file path of the filter configuration file to use to filter the argument DICOM files can be generated using the DICOM Filter GUI Application run the application in console mode if present logging will be enabled and all log messages w
76. one or more custom transfer syntax entries to enable graceful handling of a wide variety of non standard and incorrect transfer syntax values e Add Custom Transfer Syntax UID and Name by selecting this option in the drop down list and clicking the add button the user can enter any desired transfer syntax UID and Name The list automatically prevents duplicate or blank UIDs from being entered PowerTools User Manual 2015 Laurel Bridge Software Inc All Rights Reserved v1 0 34 32 Transfer Syntaxes for Presentation Context Megotiation Add Custom Transfer Syntax UID and Name 1 2 840 10008 1 2 4 81 JPEG LS Lossy Near Lossless 1 2 840 10008 1 2 4 100 MPEG Main Profile Main Level 1 2 840 10008 1 2 4 101 MPEG2 Main Profile High Level 1 2 840 10008 1 2 4 92 JPEG 2000 Part 2 Multi component Lossless Only 1 2 840 10008 1 2 4 93 JPEG 2000 Part 2 Multi component 1 2 840 10008 1 2 2 Explicit VR Big Endian 1 2 3 4 5 6 aniste Extended Transfer Syntax settings management in Store Server 4 3 2 Query Server Query Server provides a command line interface to a query SCP for a directory of DICOM files on disk 4 3 3 Modality Worklist Server Modality Worklist Server provides a command line interface to common functionality of a modality worklist server that accesses its data from a directory on disk and is suitable for testing troubleshooting and as a developer tool 4 3 4 Verificatio
77. orresponds to Accession Number and the second column of values corresponds to Study Instance UID The third column of values corresponds to Patient s Name the fourth to Patient ID and the fifth to Study Date When a new DICOM data set arrives to be filtered the values for the two DICOM elements in the data set described by the first two columns will be compared against every row in the Mapping File for a match If a match 1s found then the replace values in columns 3 5 will be inserted overwritten for the Replace Tags List These DICOM elements will only be overwritten in this example if a match is found Here is an example row for this case 1 2 3 4 3 3 1 2 4 JOHN 7 6 5 4 3 2 1 20091215 For this row to apply the DICOM data set passed in must have its Accession Number set to 1 2 3 4 and its Study Instance UID set to 3 3 1 2 4 If this matches then the Patient s Name will be changed to JOHN the Patient ID will be changed to 7 6 5 4 3 2 1 and the Study Date will be changed to 20091215 9 Mapping List Mapping File C mapping list csv E Delimiter Comma WoMatch Action Continue Y Match Tag Study Instance UID OQ Column Tag Name 1 0008 0050 Accession Number 2 0020 000D Study Instance UID Replace Tag Study Date Column Tag Name a 0010 0010 Patient s Name 4 0010 0020 Patient ID n nnna nn2n Shudv Nate e Move moves one DICOM element s value to another DICOM ele
78. overwrites it if it already exists in the DICOM data set In this example the Patient s Weight element is inserted into the DICOM data set and given a value of 200 Any previous value if 1t existed 1s overwritten 9 Insert Ove Patient s Weight 200 Mapping List performs a mapping based upon the arguments given This 1s very useful if a large number of DICOM data sets need to be changed depending upon a large list of values for particular DICOM elements in those data sets Arguments for this action are as follows o Mapping File a list of values separated by Delimiter Each row of values should contain as many columns as is specified by the largest Column listed o Delimiter the character used to separate values in the Mapping File o No Match Action the action to perform if unable to find a match for the current DICOM data set using the Match Tag List selected PowerTools User Manual 2015 Laurel Bridge Software Inc All Rights Reserved v1 0 34 o Match Tag List a list of tags to match against the current DICOM data set being filtered These represent the first columns of values in the Mapping File o Replace Tag List a list of tags to replace with the values given in the Mapping File should a match occur In this example the mapping file C Xmapping list csv should contain five columns of values each separated by a Comma If there is no match the action will Continue The first column of values c
79. place Value as Macro Name Replace Value GUIDO This macro function will generate a new GUID at the desired position Define the Replace Value using only the function Macro Name Replace Value myquid GUIDO To use these two specific examples of a TIMESTAMP and GUID add the corresponding macro name references in the desired spots in the message template MSH amp RAD CDIC today ORM 001 myguid P 2 3 Embedded Macro Functions For convenience macro functions described above can be embedded directly inside the message template using the same format as was used above for the ReplaceValue macro function For example embedding a TIMESTAMP and GUID in the first line of the message template looks like this MSH amp RAD CDIC TIMESTAMP yyyyMMddHHmmss ORM 001 GUID I P 12 3 Note that the syntax for the macro functions is the same as when they are used in the ReplaceValue field PowerTools User Manual 2015 Laurel Bridge Software Inc All Rights Reserved v1 0 34 52 5 Advanced Filtering 5 1 Composer Filter Action The Composer action uses NET regular expressions to parse an element s value and combine the parts into new elements 1 Swap two tags Swap the Patient s Name and the Patient ID to be in each other s place you would specify the following inputs lag Input Pattern 0010 0010 0010 0020 The regexes shown here mean that the entire value should
80. pops up when an item in the list is right clicked Depending on the current mode an item can be added added as a child of the selected item removed along with any child items or the entire list can be cleared Tags Add Remove Active Source Diameter add 1 Remove Active Source Diameter 13 Tag Mame Value a D 0010 Patient s Birth D D010 Patient s Sex 000 Modal dd Child 004 Schec 004 Schec Tag Mame Value 0008 0020 Study Date EEXENIT 0008 0060 Modality 0010 0010 Patient s I 0010 0020 Patent I 0020 000D Study Instance UID Remove Remove All Remove Remove Tree 3 004 Schec Remove All i 004 Scheduled Perf L 004 Scheduled Proc Context menu in Find Move mode Context menu in MWL mode PowerTools User Manual 2015 Laurel Bridge Software Inc All Rights Reserved v1 0 34 22 e Use Default Tags populates the list with default query tags appropriate to the currently selected mode Find Move queries have a Minimal and Standard set of defaults while MWL queries have Minimal Standard and Extended default sets Minimal MWL Tags Standard MWL Tags Extended MWL Tags Predefined default tag sets are available 2 for Find Move 3 for MWL e Find Move MWL Query clicking this button initiates a C Find C Move or Modality Worklist query operation to the query SCP using the specified information e Query Timeout the amount of time in seconds to wait b
81. restoration are only available as long as a valid private certificate and password 1s available This private certificate must pair with the public certificate used to de identify the original DICOM dataset Select one of the following actions when re identifying a dataset to dictate how to handle the original SOP Instance UID e Restore Original UID Select this option to restore the original SOP Instance UID This option will not create a Referenced Image Sequence 0008 1140 PowerTools User Manual 2015 Laurel Bridge Software Inc All Rights Reserved v1 0 34 59 e Create a New UID and Reference Original Select this option in order to create a new SOP Instance UID and create a Referenced Image Sequence 0008 1140 that references the original SOP Instance UID that was de identified e Create a New UID and Do Not Reference Original This option will create a new SOP Instance UID for the re identified dataset without creating a Referenced Image Sequence 0008 1140 5 3 1 Additional Notes Enable Logging This option enables logging for the re identification process Patient Identity Removed 0012 0062 Attribute Tag will be added to the re identified dataset in all cases including selecting Restore Original UID As per PS 3 15 Annex E Attribute Confidentiality Profile the following Attribute Tags are added when re identifying a given DICOM dataset unless restoring the original SOP Instance UID e Patent Iden
82. s User Manual 2015 Laurel Bridge Software Inc All Rights Reserved v1 0 34 Store Server application before and after window renaming Note the text in the title bar has changed from Store Server Laurel Bridge Software to Store Server 5 Note that the new name in the title bar only persists until that application instance exits The next time the application is run it will have the original standard title in the title bar This renaming feature is also available when starting any of the GUI applications that support renaming at the command line and is particularly helpful when scripting the startup of a number of collaborating applications This 1s done using the name command line switch An example of starting up one renamed Store Server and three renamed Study Generator instances 1s provided in the demo batch script example gui renaming bat in the PowerTools installation directory 4 1 8 External Data Dictionary Management The Dicom File Editor and Dictionary Finder applications provide access to functionality that selects and manages an external data dictionary When activated via an options setting a status indicator appears in the upper right of the main application window DICOM DICONDE Custom Dictionary Image Indicates that no external A DICONDE external data A user customized external data dictionary is loaded dictionary is loaded data dictionary is loaded When the indicator is visible clicking on it opens the extern
83. s wi Xxx Filter Actions e Change Case changes the alphabetical case of a DICOM element s value to either all uppercase or all lowercase In this example Patient s Name is changed to all Lower case 5 xi Change Case Patient s Name v Upper Lower e De ldentify provides a sophisticated mechanism to remove and replace certain attributes within a DICOM dataset that may lead to patient identification For details on use of the De Identify filter action see section 5 2 De Identify Filter Action below e Composer supports the merging and splitting of elements It can also be used to manipulate DICOM sequence elements with ease It uses regular expressions to parse values from DICOM tags and combine the values into other DICOM tags For example it can take parts from two different tags and combine them to make a new value in a third tag Regular expressions are specified to parse each input tag and substitution patterns determine how the output tags are constructed For details on advanced use of the Composer filter action see section 5 1 Composer Filter Action below Input Patterns Output Elements Output Patterns In the Input Elements table specify the tags and how the regular expressions should parse each value into groups the regular expressions go into the Input Patterns column The groups that are produced are specified in the Output Patterns column of the Output Elements table The first match i
84. te from the list of attributes to de identify PowerTools User Manual 2015 Laurel Bridge Software Inc All Rights Reserved v1 0 34 56 5 22 Miscellaneous Settings These settings allow for finer grained control over common options needed during de identification e Anonymize Pixel Data If selected the list of rectangles defined in the Pixel Regions to Anonymize grid will be removed from the DICOM dataset s pixel data This includes pixel data in 7FEO 0010 and not any additional overlays or private tags This option will be skipped if no valid pixel data is present in the DICOM dataset e Enable Re Identification If checked the original values for each attribute anonymized will be persisted in the resulting de 1dentified dataset using the specified public certificate More information about this process 1s specified later in this section e Retain Date and Time Information If this option is checked all date and time information DT and TM elements will not be anonymized This option may be useful when performing clinical trials where the DICOM dataset s date and time information may need to be retained after de identification e Skip Unsupported Images When anonymizing a dataset s pixel data again referring only to pixel data in 7FEO 0010 enabling this option will cause the filter to not anonymize the pixel data for all unsupported photometric interpretations For instance anonymizing the pixel data for
85. ter configuration to disk allows configurations to be shared between PowerTools utilities e Filter the list of filters 1n order of execution filters are chained together to be applied to the DICOM communication The buttons at the bottom of the filter list allow filters to be added removed moved up in execution order and moved down in execution order e Conditions a list of conditions to check against to decide whether or not to apply actions Conditions are checked in order as listed to change the order click the up or down buttons for the condition e Actions a list of actions to perform on the DICOM data if the conditions were true Actions are applied in order as listed to change the order click the up or down buttons for the action e Match All Match Any selects whether all conditions in the current filter must match before applying actions or whether only one condition is required to match e OKc exits the Filter Editor Dialog and saves any changes e Cancel exits the Filter Editor Dialog without saving PowerTools User Manual 2015 Laurel Bridge Software Inc All Rights Reserved v1 0 34 Filter Conditions e DICOM Tag condition which checks a DICOM element for certain requirements DICOM Tag allows specification of a DICOM tag and an operator to check against the tag s value In this example if Patient s Name Contains XXX then the condition is true 9 Dicom Tag Patient s Name v Contain
86. that must be installed before the application can function correctly These prerequisites consist of Microsoft NET Framework 3 5 Visual C Runtime Libraries x86 Windows Installer 3 1 The main installer executable Setup exe will determine whether these prerequisites are needed and install them accordingly If it is desired to install an older version of PowerTools than the currently installed version or to reinstall the current version it 1s necessary to first uninstall the current version 22 Installing PowerTools After installing the prerequisites the PowerTools installer PowerTools msi will run For machines with an older version of PowerTools installed this installer will upgrade any previous installation while maintaining any current configuration settings PowerTools User Manual 2015 Laurel Bridge Software Inc All Rights Reserved v1 0 34 3 Getting Started 3 1 Installing a License The first step after launching PowerTools is to install a license Running the PowerTools Launcher application from the start menu for the first time will bring up a dialog allowing a license to be installed When the About Laurel Bridge PowerTools dialog appears click the Install License button browse to the license file and hit OK Information on the status of the license including when it expires can be found on this dialog available at any time by clicking Help gt About in any PowerTools GUI application The license
87. the application is exited the user is presented with a dialog offering the option of deleting these 1mage and log files before exiting If the Don t ask me again checkbox is checked this dialog will not appear again unless the feature is reset in the Options dialog Clear All Before Exit Before exiting would you like to delete all image and log files corresonding to the entries listed in the store table No Cancel Don t ask me again The Clear All Before Exit dialog of the Store Server Advanced settings in Store Server are described below Automatically Start Server On Application Start Don t ask to dear all on exit v Favor SCU Proposed Presentation Contexts e Automatically Start Server On Application Start if checked then the server will attempt to start immediately upon application startup e Don t ask to clear all on exit 1f checked then the Clear All On Exit dialog will not appear on application exit e Favor SCU Proposed Presentation Contexts if checked then the connecting SCU will be given preference when negotiation presentation contexts If unchecked then Store Server will negotiate presentation contexts based upon its Supported Server Transfer Syntaxes For Presentation Context Negotiation List The Transfer Syntaxes for Presentation Context Negotiation setting section 4 1 6 that 1s common in a number of client and server applications has been extended in the Store Server with the ability to add
88. the same name e Save and View performs a Save of the Mapping File data and then opens the file for viewing in the default system text file viewing application e g Notepad PowerTools User Manual 2015 Laurel Bridge Software Inc All Rights Reserved v1 0 34 48 45 HL7 Applications PowerTools provides two Health Level 7 HL7 applications for sending and receiving HL messages The tools are under continuing development An overview of each is provided below 4 5 1 HL7 Receiver The HL7 Receiver is a server that manages communication with an HL7 Sender client receiving messages and optionally replying with ACK responses The user interface provides the following configurable options and information display components e Listen Port the port on which the server will listen for incoming connections and HL7 messages Enable SSL when checked enables an SSL connection with an HL7 Sender SSL Certificate selects the file containing the SSL certificate Password the password associated with the SSL certificate Send ACK when checked causes the application to send a general acknowledgement ACK message to the HL7 Sender when it has received a message e Send AR when checked causes the application to send an AR acknowledgement ACK message to the HL7 Sender when it has received a message e Verbose Window when checked messages are logged in the message window e Message Received a count of the numb
89. tions Dialog in DICOM File Editor allows the specification of several unique settings Options View Log Log Level View Loq Directory Dicom Terse settings Value Separator Character s Comma and Backslash Save Files in Ch 10 Format Ww Invent Group 2 Data Read Invalid VR as Implicit Advanced Show external data dictionary indicator Manage v Show names for well known UIDs Display UN element values as text when possible 10 Items shown in Recent Files list OK Cancel e Enable Logging Checking this option will enable logging for DICOM File Editor use For more description of logging see the description of the Options Dialog in section 4 1 2 e Value Separator Characters s specifies the character s to use to separate multi valued elements in the main value display o Comma and Backslash a multi valued element will appear as a b or 1 2 o Newline a multi valued element will place each new value on a new line e Save Files in Ch 10 Format when checked data sets will be saved in Chapter 10 format e Invent Group 2 Data when checked group 2 data will be invented if needed e Read Invalid VR as Implicit an advanced and rarely needed option it enables data sets containing a variety of errors to be opened and viewed e Show external data dictionary indicator when checked the external data dictionary indicator 1s displayed on the menu bar section 4 1 8 e Manage when clicked the Se
90. tity Removed 0012 0062 e Purpose of Referenced Code Sequence 0040 A170 e Referenced Image Sequence 0008 1140 PowerTools User Manual 2015 Laurel Bridge Software Inc All Rights Reserved v1 0 34 60 6 Console Applications 6 1 Overview The console applications contained in PowerTools are accessible via the PowerTools Console shortcut placed in the Start Menu on installation see section 3 3 and also from the shortcut to the PowerTools Console on the PowerTools Launcher GUI application Many of the console applications are combined with the GUI version of the same application and are run using a nogui flag All console and GUI applications contain a usage statement which can be displayed by running the application with a h flag although the nogui flag is also required for those that are combined GUI and console applications Note that most all of the console applications all are very similar in functionality to their GUI counterparts For example the GUI help message for the GUI version of the Query Client can be obtained by running this command DicomFilter h Running this command results is a help dialog popping up that looks like this DICOM Filter Usage O This command line interface can be used to specify a configuration file to use for this execution of the application z Usage DicomFilter exe config CFG FILE backup nogui h display command line usage config CFG FILE the application configurati
91. to the server If logging is enabled then a log of the C Echo will be recorded A check means that the verification was successful an X means that it was not 4 1 5 Server Routing Information All server GUI applications have the same interface for specifying routing information and for restricting which clients can connect Client AE Title v Allow Any Server AE Title Allow Any Client IP Address v Allow Any Server Host Default Client Port Allow Any Server Port 11112 Client AE Title reject any connecting clients that do not have the specified Application Entity title select Allow Any to accept a client using any AE title Client IP Address reject any connecting clients that are not connecting from the specified IP address select Allow Any to accept a client connecting from any IP address Client Port reject any connecting clients that are not connecting using the specified port number select Allow Any to accept a client connecting using any port number Server AE Title reject any connecting clients that are not attempting to connect to the server with the specified server Application Entity title select Allow Any to accept a client regardless of the AE title it is using for the server Server Host the IP address on the local machine on which to establish the server Server Port the port number on the local machine on which to establish the server 4 1 6 Transfer Syntaxes for Presentat
92. uding header 24 a is Fis A tooltip reports bytes stored for each element When hovering over the VR of an element a tooltip describes the meaning of the VR LT Us 1 C 12 MONOCHROME Uus 1 2 5L2 A tooltip describes each VR In this example LT is Long Text Long Text For Pixel Data elements that are stored 1n a compressed format their Length 1s correctly reported as 1 and the Length field is highlighted Pixel Data element data size information 1s reported in a tooltip PowerTools User Manual 2015 Laurel Bridge Software Inc All Rights Reserved v1 0 34 40 08 i 0x0000 0x0000 0x0000 0x000 Tr Uncompressed length 524288 Offset 0x000069C2 27074 Header 12 Data 56484 Highlighting of Length field for Pixel Data elements is shown indicating data size tooltip is available It is possible that a file containing compressed Pixel Data claims to store its data as OW even when the data 1s OB In this case the VR field 1s highlighted and a tooltip explaining the discrepancy can be shown This discrepancy can be confirmed using the hex view panel TE io Other Byte File says Other Word Stored encoding is reported for OB data as OW in file When an element is clicked on in the header view panel the corresponding bytes for that element are highlighted in the hex view panel Similarly when some byte is clicked in the hex view panel the element that contains that byte and
93. v1 0 34 21 Tags Tags Add Remove Physician s of Record Add Remove Physician s of Record Tag Mame Tag Name 0020 000D Study Instance UID 0040 0100 Scheduled Procedure Step Sequence 0008 0020 Study Date 1 D040 0001 Scheduled Station AE Title 0008 0050 Accession Number E 0040 0002 Scheduled Procedure Step Start Date 0010 0010 Patient s Name 10008 0050 Modality 0010 0020 Patent ID 0020 0000 Study Instance UID 0008 0060 Modality 7 0008 0020 Study Date S 0008 0050 Accession Number MTT D010 0010 Patient s Name i D010 0020 Patient ID Use Default Tags Use Default Tags MWL Query Query Tag List in Find Mode Query Tag List in MWL Mode The green plus and red minus buttons are used to Add a tag to the list or to Remove the selected item if any from the list of items The green up and down arrows move the selected item up or down in the list When in MWL mode where there Query Tag List can be in a tree layout the Add button will add a tag as a child of the currently selected item in the list or at the top level of the list if no item in the list is selected In Find or Move mode the Add button simply adds a tag to the list In all modes the Remove button will immediately remove any item that has no child items In MWL mode the Remove button will cause a prompt for confirmation before removing a selected item and all of its child items if that item has one or more child items A context menu
94. ved v1 0 34 20 Query Type amp Method Find Relational Move AE Title Root Study Level Image Move mode queries a query SCP in the same way but instead of returning the found DICOM elements the entire DICOM data sets which match are sent to the Move destination described by the Move AE Title the query server should have a mapping for this AE title so that it knows where to send the DICOM images Relational and Hierarchical search methods support queries to PACS of the corresponding query architecture Type amp Method Move Relational Move AE Title EXAMPLE AE Root Study Level Study MWL mode enables a mechanism for performing Modality Worklist queries using the Query Client user interface When the application is in MWL mode Modality Worklist queries of arbitrary depth can be crafted in the Query Tag List Query Type amp Method MW Relational Move AE Title Root Level Key components of the Query Client user interface include e Info Model Root the information model of the query server Study Patient or PatientStudy e Query Level the level at which to query on the server Patient Study Series or Image e Query Tag List a list of tags with which to query the query SCP Values can be edited to request a match and if left blank that value will be filled in upon return PowerTools User Manual 2015 Laurel Bridge Software Inc All Rights Reserved

PowerTools User Manual

Contents

Download Pdf Manuals

Related Search

Related Contents