Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

The Simple Pipeline Fabricator can save your pipeline in a reusable Piper File, as well as load and run Piper Files.  It only assists creating cTAKES pipelines, displaying information and allowing selection of available Readers, Annotators and Writers (Pipe Bits).  It also displays information and facilitates assigning values to Pipe Bit parameters.  However, creating a proper working pipeline requires knowledge of basic NLP artifacts and dataflow. 

Step-by-step guide

Before or while using the Simple Pipeline Fabricator GUI, reference the information on Piper Files.

  1. From a command-line in the cTAKES root directory, execute: bin/runPiperCreator
    Image Added
  2. Click Scan to allow the tool to discover all pipeline components (Pipe Bits) available to cTAKES.  The scan may take several seconds.
    Image Added
  3. Select a Pipe Bit on the left.  Information on the Pipe Bit will be displayed in the center pane.
  4. Select a Parameter Name in the center table.  Information on the Parameter will be displayed below the table.
  5. Enter a Value in the table for any parameter that requires one.   An 'open file' button makes file selection easy.
  6. Click Add(plus) when all parameter requirements are met.  The Pipe Bit will be added to the piper file on the right.
    Image Added
  7. Continue to Add pipe bits in order to create your pipeline.
  8. Click Validate Image Added at any time.  A valid piper will activate the run button.
  9. Click SaveImage Addedto save your piper file for future use.
  10. Click Run Image Added to run your pipeline within the GUI.  If your pipeline is complex or you have a large amount of input/output, running with a bin/runPiperFile script is recommended. 

 

Info

There are four basic types of pipe bit: Reader Image Added, Annotator Image Added , Writer Image Added and Utility Image Added

Pipe Bits in the Available Pipe Bit list have icons indicating dependency data types and product datatypes. Icons to the left of the pipe bit name are dependencies. Icons to the right are products.

The Available Pipe Bit list sorts pipe bits by complexity of datatype dependencies. Bits in your pipeline should follow the same general order.

Older (pre-uimaFIT™) Pipe Bits will not display parameter information. Use with care.

Unrecognized pipe bits without @PipeBitInfo Java annotations will have a grey background in the Available Pipe Bit list. Use with care.

The Piper File editor on the right has some simple text coloring. If a command is invalid it will be displayed in underlined red.

Lines added by the tool are verbose. You can manually edit or rearrange them to improve the piper file. Click Validate to confirm a good edit.

Occasionally Validate will "time out" - there will be a message in the bottom log panel. Click Validate again.

Image Added

General datatypes and their associated icons in the Available Pipe Bit list

Content by Label
showLabelsfalse
max5
spacesCTAKES
showSpacefalse
sortmodified
reversetrue
typepage
cqllabel in ("pipeline","piper","gui") and type = "page" and space = "CTAKES"
labelsPipeline Piper GUI

...