rtp-connect 1.0

data/README.rdoc

@@ -0,0 +1,128 @@
+= RTPConnect
+
+The RTPConnect library allows you to read, edit and write RTPConnect files in Ruby.
+RTPConnect is a file format used in radiotherapy (e.g. Mosaiq) for export & import
+of treatment planning data. The library is written entirely in Ruby and has no
+external dependencies.
+
+
+== INSTALLATION
+
+  gem install rtp-connect
+
+
+== REQUIREMENTS
+
+* Ruby 1.9.2
+
+
+== BASIC USAGE
+
+=== Load & Include
+
+  require 'rtp-connect'
+  include RTP
+
+=== Read, modify and write
+
+  # Read file:
+  rtp = Plan.read("some_file.rtp")
+  # Extract the Patient's Name:
+  name = rtp.patient_last_name
+  # Modify the Patient's Name:
+  rtp.patient_last_name = "Anonymous"
+  # Write to file:
+  rtp.write("new_file.rtp")
+
+=== Create a new Plan Definition Record from scratch
+
+  # Create the instance:
+  rtp = Plan.new
+  # Set the Patient's ID attribute:
+  rtp.patient_id = "12345"
+  # Export the instance to an RTP string (with CRC):
+  output = rtp.to_str
+
+=== Log settings
+
+  # Change the log level so that only error messages are displayed:
+  RTP.logger.level = Logger::ERROR
+  # Setting up a simple file log:
+  l = Logger.new('my_logfile.log')
+  RTP.logger = l
+  # Create a logger which ages logfile daily/monthly:
+  RTP.logger = Logger.new('foo.log', 'daily')
+  RTP.logger = Logger.new('foo.log', 'monthly')
+
+=== Scripts
+
+For more thorough examples, check out the scripts folder which contains
+numerous ruby scripts that shows of real world usage scenarios of the
+RTPConnect library.
+
+=== IRB Tip
+
+When working with the RTPConnect library in irb, you may be annoyed with all
+the information that is printed to screen, regardless of your log level.
+This is because in irb every variable loaded in the program is
+automatically printed to the screen. A useful hack to avoid this effect is
+to append ";0" after a command.
+
+Example:
+  rtp = Plan.read("some_file.rtp") ;0
+
+
+== RESOURCES
+
+* {Rubygems download}[https://rubygems.org/gems/rtp-connect]
+* {Source code repository}[https://github.com/dicom/rtp-connect]
+
+
+== RESTRICTIONS
+
+=== Supported records
+
+* Plan definition [PLAN_DEF]
+* Prescription site [RX_DEF]
+* Site setup [SITE_SETUP_DEF]
+* Treatment field [FIELD_DEF]
+* Extended treatment field [EXTENDED_FIELD_DEF]
+* Control point record [CONTROL_PT_DEF]
+
+=== Unsupported records
+
+* Simulation field [SIM_DEF]
+* Document based treatment field [PDF_FIELD_DEF]
+* Multileaf collimator [MLC_DEF]
+* MLC shape [MLC_SHAPE_DEF]
+* Dose tracking record [DOSE_DEF]
+* Dose action points [DOSE_ACTION]
+
+If you encounter an RTP file with an unsupported record type, please contact me.
+
+
+== COPYRIGHT
+
+Copyright 2011 Christoffer Lervag
+
+This program is free software: you can redistribute it and/or modify
+it under the terms of the GNU General Public License as published by
+the Free Software Foundation, either version 3 of the License, or
+(at your option) any later version.
+
+This program is distributed in the hope that it will be useful,
+but WITHOUT ANY WARRANTY; without even the implied warranty of
+MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+GNU General Public License for more details.
+
+You should have received a copy of the GNU General Public License
+along with this program.  If not, see http://www.gnu.org/licenses/ .
+
+
+== ABOUT THE AUTHOR
+
+* Name: Christoffer Lervag
+* Location: Norway
+* Email: chris.lervag [@nospam.com] @gmail.com
+
+Please don't hesitate to email me if you have any feedback related to this project!

data/lib/rtp-connect.rb

@@ -0,0 +1,20 @@
+# Loads the files that are used by the RTPConnect library.
+
+# Logging:
+require_relative 'rtp-connect/logging'
+# Super classes:
+require_relative 'rtp-connect/record'
+# Core library:
+require_relative 'rtp-connect/plan'
+require_relative 'rtp-connect/prescription'
+require_relative 'rtp-connect/site_setup'
+require_relative 'rtp-connect/field'
+require_relative 'rtp-connect/extended_field'
+require_relative 'rtp-connect/control_point'
+# Extensions to the Ruby library:
+require_relative 'rtp-connect/ruby_extensions'
+# Module settings:
+require_relative 'rtp-connect/version'
+require_relative 'rtp-connect/constants'
+require_relative 'rtp-connect/methods'
+require_relative 'rtp-connect/variables'

data/lib/rtp-connect/constants.rb

@@ -0,0 +1,58 @@
+module RTP
+
+  # The seed value used in the RTPConnect implementation of the CCITT algorithm.
+  CRC_SEED = 0x0521
+
+  # The table & values used in the RTPConnect implementation of the CCITT algorithm.
+  CRC_TABLE = [
+    0x0000, 0xC0C1, 0xC181, 0x0140, 0xC301, 0x03C0, 0x0280, 0xC241,
+    0xC601, 0x06C0, 0x0780, 0xC741, 0x0500, 0xC5C1, 0xC481, 0x0440,
+    0xCC01, 0x0CC0, 0x0D80, 0xCD41, 0x0F00, 0xCFC1, 0xCE81, 0x0E40,
+    0x0A00, 0xCAC1, 0xCB81, 0x0B40, 0xC901, 0x09C0, 0x0880, 0xC841,
+    0xD801, 0x18C0, 0x1980, 0xD941, 0x1B00, 0xDBC1, 0xDA81, 0x1A40,
+    0x1E00, 0xDEC1, 0xDF81, 0x1F40, 0xDD01, 0x1DC0, 0x1C80, 0xDC41,
+    0x1400, 0xD4C1, 0xD581, 0x1540, 0xD701, 0x17C0, 0x1680, 0xD641,
+    0xD201, 0x12C0, 0x1380, 0xD341, 0x1100, 0xD1C1, 0xD081, 0x1040,
+    0xF001, 0x30C0, 0x3180, 0xF141, 0x3300, 0xF3C1, 0xF281, 0x3240,
+    0x3600, 0xF6C1, 0xF781, 0x3740, 0xF501, 0x35C0, 0x3480, 0xF441,
+    0x3C00, 0xFCC1, 0xFD81, 0x3D40, 0xFF01, 0x3FC0, 0x3E80, 0xFE41,
+    0xFA01, 0x3AC0, 0x3B80, 0xFB41, 0x3900, 0xF9C1, 0xF881, 0x3840,
+    0x2800, 0xE8C1, 0xE981, 0x2940, 0xEB01, 0x2BC0, 0x2A80, 0xEA41,
+    0xEE01, 0x2EC0, 0x2F80, 0xEF41, 0x2D00, 0xEDC1, 0xEC81, 0x2C40,
+    0xE401, 0x24C0, 0x2580, 0xE541, 0x2700, 0xE7C1, 0xE681, 0x2640,
+    0x2200, 0xE2C1, 0xE381, 0x2340, 0xE101, 0x21C0, 0x2080, 0xE041,
+    0xA001, 0x60C0, 0x6180, 0xA141, 0x6300, 0xA3C1, 0xA281, 0x6240,
+    0x6600, 0xA6C1, 0xA781, 0x6740, 0xA501, 0x65C0, 0x6480, 0xA441,
+    0x6C00, 0xACC1, 0xAD81, 0x6D40, 0xAF01, 0x6FC0, 0x6E80, 0xAE41,
+    0xAA01, 0x6AC0, 0x6B80, 0xAB41, 0x6900, 0xA9C1, 0xA881, 0x6840,
+    0x7800, 0xB8C1, 0xB981, 0x7940, 0xBB01, 0x7BC0, 0x7A80, 0xBA41,
+    0xBE01, 0x7EC0, 0x7F80, 0xBF41, 0x7D00, 0xBDC1, 0xBC81, 0x7C40,
+    0xB401, 0x74C0, 0x7580, 0xB541, 0x7700, 0xB7C1, 0xB681, 0x7640,
+    0x7200, 0xB2C1, 0xB381, 0x7340, 0xB101, 0x71C0, 0x7080, 0xB041,
+    0x5000, 0x90C1, 0x9181, 0x5140, 0x9301, 0x53C0, 0x5280, 0x9241,
+    0x9601, 0x56C0, 0x5780, 0x9741, 0x5500, 0x95C1, 0x9481, 0x5440,
+    0x9C01, 0x5CC0, 0x5D80, 0x9D41, 0x5F00, 0x9FC1, 0x9E81, 0x5E40,
+    0x5A00, 0x9AC1, 0x9B81, 0x5B40, 0x9901, 0x59C0, 0x5880, 0x9841,
+    0x8801, 0x48C0, 0x4980, 0x8941, 0x4B00, 0x8BC1, 0x8A81, 0x4A40,
+    0x4E00, 0x8EC1, 0x8F81, 0x4F40, 0x8D01, 0x4DC0, 0x4C80, 0x8C41,
+    0x4400, 0x84C1, 0x8581, 0x4540, 0x8701, 0x47C0, 0x4680, 0x8641,
+    0x8201, 0x42C0, 0x4380, 0x8341, 0x4100, 0x81C1, 0x8081, 0x4040
+  ]
+
+  # Pairs of RTPConnect keywords and parse method names.
+  PARSE_METHOD = {
+    "PLAN_DEF" => :plan_definition,
+    "RX_DEF" => :prescription_site,
+    "SITE_SETUP_DEF" => :site_setup,
+    "SIM_DEF" => :simulation_field,
+    "FIELD_DEF" => :treatment_field,
+    "EXTENDED_FIELD_DEF" => :extended_treatment_field,
+    "PDF_FIELD_DEF" => :document_based_treatment_field,
+    "MLC_DEF" => :multileaf_collimator,
+    "CONTROL_PT_DEF" => :control_point,
+    "MLC_SHAPE_DEF" => :mlc_shape,
+    "DOSE_DEF" => :dose_tracking,
+    "DOSE_ACTION" => :dose_action,
+  }
+
+end

data/lib/rtp-connect/control_point.rb

@@ -0,0 +1,444 @@
+module RTP
+
+  # The ControlPoint class.
+  #
+  # === Relations
+  #
+  # * Parent: Field
+  # * Children: MLCShape
+  #
+  class ControlPoint < Record
+
+    # The Record which this instance belongs to.
+    attr_reader :parent
+    # The MLC shape record (if any) that belongs to this ControlPoint.
+    attr_reader :mlc_shape
+    attr_reader :field_id
+    attr_reader :mlc_type
+    attr_reader :mlc_leaves
+    attr_reader :total_control_points
+    attr_reader :control_pt_number
+    attr_reader :mu_convention
+    attr_reader :monitor_units
+    attr_reader :wedge_position
+    attr_reader :energy
+    attr_reader :doserate
+    attr_reader :ssd
+    attr_reader :scale_convention
+    attr_reader :gantry_angle
+    attr_reader :gantry_dir
+    attr_reader :collimator_angle
+    attr_reader :collimator_dir
+    attr_reader :field_x_mode
+    attr_reader :field_x
+    attr_reader :collimator_x1
+    attr_reader :collimator_x2
+    attr_reader :field_y_mode
+    attr_reader :field_y
+    attr_reader :collimator_y1
+    attr_reader :collimator_y2
+    attr_reader :couch_vertical
+    attr_reader :couch_lateral
+    attr_reader :couch_longitudinal
+    attr_reader :couch_angle
+    attr_reader :couch_dir
+    attr_reader :couch_pedestal
+    attr_reader :couch_ped_dir
+    # Note: This attribute contains an array of all MLC LP A values (leaves 1..100).
+    attr_reader :mlc_lp_a
+    # Note: This attribute contains an array of all MLC LP B values (leaves 1..100).
+    attr_reader :mlc_lp_b
+
+    # Creates a new ControlPoint by parsing a RTPConnect string line.
+    #
+    # === Parameters
+    #
+    # * <tt>string</tt> -- A string containing a control point record.
+    # * <tt>parent</tt> -- A Record which is used to determine the proper parent of this instance.
+    #
+    def self.load(string, parent)
+      raise ArgumentError, "Invalid argument 'string'. Expected String, got #{string.class}." unless string.is_a?(String)
+      raise ArgumentError, "Invalid argument 'parent'. Expected RTP::Record, got #{parent.class}." unless parent.is_a?(RTP::Record)
+      # Get the quote-less values:
+      values = string.values
+      raise ArgumentError, "Invalid argument 'string': Expected exactly 233 elements, got #{values.length}." unless values.length == 233
+      f = self.new(parent)
+      # Assign the values to attributes:
+      f.keyword = values[0]
+      f.field_id = values[1]
+      f.mlc_type = values[2]
+      f.mlc_leaves = values[3]
+      f.total_control_points = values[4]
+      f.control_pt_number = values[5]
+      f.mu_convention = values[6]
+      f.monitor_units = values[7]
+      f.wedge_position = values[8]
+      f.energy = values[9]
+      f.doserate = values[10]
+      f.ssd = values[11]
+      f.scale_convention = values[12]
+      f.gantry_angle = values[13]
+      f.gantry_dir = values[14]
+      f.collimator_angle = values[15]
+      f.collimator_dir = values[16]
+      f.field_x_mode = values[17]
+      f.field_x = values[18]
+      f.collimator_x1 = values[19]
+      f.collimator_x2 = values[20]
+      f.field_y_mode = values[21]
+      f.field_y = values[22]
+      f.collimator_y1 = values[23]
+      f.collimator_y2 = values[24]
+      f.couch_vertical = values[25]
+      f.couch_lateral = values[26]
+      f.couch_longitudinal = values[27]
+      f.couch_angle = values[28]
+      f.couch_dir = values[29]
+      f.couch_pedestal = values[30]
+      f.couch_ped_dir = values[31]
+      f.mlc_lp_a = [*values[32..131]]
+      f.mlc_lp_b = [*values[132..231]]
+      f.crc = values[232]
+      return f
+    end
+
+    # Creates a new ControlPoint.
+    #
+    # === Parameters
+    #
+    # * <tt>parent</tt> -- A Record which is used to determine the proper parent of this instance.
+    #
+    def initialize(parent)
+      raise ArgumentError, "Invalid argument 'parent'. Expected RTP::Record, got #{parent.class}." unless parent.is_a?(RTP::Record)
+      # Child:
+      @mlc_shape = nil
+      # Parent relation:
+      @parent = get_parent(parent, Field)
+      @parent.add_control_point(self)
+      @keyword = 'CONTROL_PT_DEF'
+      @mlc_lp_a = Array.new(100)
+      @mlc_lp_b = Array.new(100)
+    end
+
+    # As of now, returns an empty array.
+    # However, by definition, this record may have an mlc shape record as child,
+    # but this is not implemented yet.
+    #
+    def children
+      #return [@mlc_shape]
+      return Array.new
+    end
+
+    # Returns the values of this instance in an array.
+    # The values does not include the CRC.
+    #
+    def values
+      return [
+        @keyword,
+        @field_id,
+        @mlc_type,
+        @mlc_leaves,
+        @total_control_points,
+        @control_pt_number,
+        @mu_convention,
+        @monitor_units,
+        @wedge_position,
+        @energy,
+        @doserate,
+        @ssd,
+        @scale_convention,
+        @gantry_angle,
+        @gantry_dir,
+        @collimator_angle,
+        @collimator_dir,
+        @field_x_mode,
+        @field_x,
+        @collimator_x1,
+        @collimator_x2,
+        @field_y_mode,
+        @field_y,
+        @collimator_y1,
+        @collimator_y2,
+        @couch_vertical,
+        @couch_lateral,
+        @couch_longitudinal,
+        @couch_angle,
+        @couch_dir,
+        @couch_pedestal,
+        @couch_ped_dir,
+        *@mlc_lp_a,
+        *@mlc_lp_b
+      ]
+    end
+
+    # Writes the ControlPoint object + any hiearchy of child objects,
+    # to a properly formatted RTPConnect ascii string.
+    #
+    def to_str
+      str = encode
+      if children
+        children.each do |child|
+          str += child.to_str
+        end
+      end
+      return str
+    end
+
+    # Sets the mlc_a attribute.
+    #
+    # === Notes
+    #
+    # As opposed to the ordinary (string) attributes, this attribute
+    # contains an array holding all 100 MLC leaf 'A' string values.
+    #
+    def mlc_lp_a=(array)
+      raise ArgumentError, "Invalid argument 'array'. Expected Array, got #{array.class}." unless array.is_a?(Array)
+      raise ArgumentError, "Invalid argument 'array'. Expected array with length 100, got #{array.length}." unless array.length == 100
+      unexpected_types = array.collect{|i| i.class}.uniq - [String, NilClass]
+      raise ArgumentError, "Invalid argument 'array'. Array must contain only string or nil values, got unexpected class #{unexpected_types}." if unexpected_types.length > 0
+      @mlc_lp_a = array
+    end
+
+    # Sets the mlc_b attribute.
+    #
+    # === Notes
+    #
+    # As opposed to the ordinary (string) attributes, this attribute
+    # contains an array holding all 100 MLC leaf 'A' string values.
+    #
+    def mlc_lp_b=(array)
+      raise ArgumentError, "Invalid argument 'array'. Expected Array, got #{array.class}." unless array.is_a?(Array)
+      raise ArgumentError, "Invalid argument 'array'. Expected array with length 100, got #{array.length}." unless array.length == 100
+      unexpected_types = array.collect{|i| i.class}.uniq - [String, NilClass]
+      raise ArgumentError, "Invalid argument 'array'. Array must contain only string or nil values, got unexpected class #{unexpected_types}." if unexpected_types.length > 0
+      @mlc_lp_b = array
+    end
+
+    # Sets the keyword attribute.
+    #
+    def keyword=(value)
+      raise ArgumentError, "Invalid argument 'value'. Expected String, got #{value.class}." unless value.is_a?(String)
+      raise ArgumentError, "Invalid keyword. Expected 'CONTROL_PT_DEF', got #{value}." unless value.upcase == "CONTROL_PT_DEF"
+      @keyword = value
+    end
+
+    # Sets the field_id attribute.
+    #
+    def field_id=(value)
+      raise ArgumentError, "Invalid argument 'value'. Expected String, got #{value.class}." unless value.is_a?(String)
+      @field_id = value
+    end
+
+    # Sets the mlc_type attribute.
+    #
+    def mlc_type=(value)
+      raise ArgumentError, "Invalid argument 'value'. Expected String, got #{value.class}." unless value.is_a?(String)
+      @mlc_type = value
+    end
+
+    # Sets the mlc_leaves attribute.
+    #
+    def mlc_leaves=(value)
+      raise ArgumentError, "Invalid argument 'value'. Expected String, got #{value.class}." unless value.is_a?(String)
+      @mlc_leaves = value
+    end
+
+    # Sets the total_control_points attribute.
+    #
+    def total_control_points=(value)
+      raise ArgumentError, "Invalid argument 'value'. Expected String, got #{value.class}." unless value.is_a?(String)
+      @total_control_points = value
+    end
+
+    # Sets the control_pt_number attribute.
+    #
+    def control_pt_number=(value)
+      raise ArgumentError, "Invalid argument 'value'. Expected String, got #{value.class}." unless value.is_a?(String)
+      @control_pt_number = value
+    end
+
+    # Sets the mu_convention attribute.
+    #
+    def mu_convention=(value)
+      raise ArgumentError, "Invalid argument 'value'. Expected String, got #{value.class}." unless value.is_a?(String)
+      @mu_convention = value
+    end
+
+    # Sets the monitor_units attribute.
+    #
+    def monitor_units=(value)
+      raise ArgumentError, "Invalid argument 'value'. Expected String, got #{value.class}." unless value.is_a?(String)
+      @monitor_units = value
+    end
+
+    # Sets the wedge_position attribute.
+    #
+    def wedge_position=(value)
+      raise ArgumentError, "Invalid argument 'value'. Expected String, got #{value.class}." unless value.is_a?(String)
+      @wedge_position = value
+    end
+
+    # Sets the energy attribute.
+    #
+    def energy=(value)
+      raise ArgumentError, "Invalid argument 'value'. Expected String, got #{value.class}." unless value.is_a?(String)
+      @energy = value
+    end
+
+    # Sets the doserate attribute.
+    #
+    def doserate=(value)
+      raise ArgumentError, "Invalid argument 'value'. Expected String, got #{value.class}." unless value.is_a?(String)
+      @doserate = value
+    end
+
+    # Sets the ssd attribute.
+    #
+    def ssd=(value)
+      raise ArgumentError, "Invalid argument 'value'. Expected String, got #{value.class}." unless value.is_a?(String)
+      @ssd = value
+    end
+
+    # Sets the scale_convention attribute.
+    #
+    def scale_convention=(value)
+      raise ArgumentError, "Invalid argument 'value'. Expected String, got #{value.class}." unless value.is_a?(String)
+      @scale_convention = value
+    end
+
+    # Sets the gantry_angle attribute.
+    #
+    def gantry_angle=(value)
+      raise ArgumentError, "Invalid argument 'value'. Expected String, got #{value.class}." unless value.is_a?(String)
+      @gantry_angle = value
+    end
+
+    # Sets the gantry_dir attribute.
+    #
+    def gantry_dir=(value)
+      raise ArgumentError, "Invalid argument 'value'. Expected String, got #{value.class}." unless value.is_a?(String)
+      @gantry_dir = value
+    end
+
+    # Sets the collimator_angle attribute.
+    #
+    def collimator_angle=(value)
+      raise ArgumentError, "Invalid argument 'value'. Expected String, got #{value.class}." unless value.is_a?(String)
+      @collimator_angle = value
+    end
+
+    # Sets the collimator_dir attribute.
+    #
+    def collimator_dir=(value)
+      raise ArgumentError, "Invalid argument 'value'. Expected String, got #{value.class}." unless value.is_a?(String)
+      @collimator_dir = value
+    end
+
+    # Sets the field_x_mode attribute.
+    #
+    def field_x_mode=(value)
+      raise ArgumentError, "Invalid argument 'value'. Expected String, got #{value.class}." unless value.is_a?(String)
+      @field_x_mode = value
+    end
+
+    # Sets the field_x attribute.
+    #
+    def field_x=(value)
+      raise ArgumentError, "Invalid argument 'value'. Expected String, got #{value.class}." unless value.is_a?(String)
+      @field_x = value
+    end
+
+    # Sets the collimator_x1 attribute.
+    #
+    def collimator_x1=(value)
+      raise ArgumentError, "Invalid argument 'value'. Expected String, got #{value.class}." unless value.is_a?(String)
+      @collimator_x1 = value
+    end
+
+    # Sets the collimator_x2 attribute.
+    #
+    def collimator_x2=(value)
+      raise ArgumentError, "Invalid argument 'value'. Expected String, got #{value.class}." unless value.is_a?(String)
+      @collimator_x2 = value
+    end
+
+    # Sets the field_y_mode attribute.
+    #
+    def field_y_mode=(value)
+      raise ArgumentError, "Invalid argument 'value'. Expected String, got #{value.class}." unless value.is_a?(String)
+      @field_y_mode = value
+    end
+
+    # Sets the field_y attribute.
+    #
+    def field_y=(value)
+      raise ArgumentError, "Invalid argument 'value'. Expected String, got #{value.class}." unless value.is_a?(String)
+      @field_y = value
+    end
+
+    # Sets the collimator_y1 attribute.
+    #
+    def collimator_y1=(value)
+      raise ArgumentError, "Invalid argument 'value'. Expected String, got #{value.class}." unless value.is_a?(String)
+      @collimator_y1 = value
+    end
+
+    # Sets the collimator_y2 attribute.
+    #
+    def collimator_y2=(value)
+      raise ArgumentError, "Invalid argument 'value'. Expected String, got #{value.class}." unless value.is_a?(String)
+      @collimator_y2 = value
+    end
+
+    # Sets the couch_vertical attribute.
+    #
+    def couch_vertical=(value)
+      raise ArgumentError, "Invalid argument 'value'. Expected String, got #{value.class}." unless value.is_a?(String)
+      @couch_vertical = value
+    end
+
+    # Sets the couch_lateral attribute.
+    #
+    def couch_lateral=(value)
+      raise ArgumentError, "Invalid argument 'value'. Expected String, got #{value.class}." unless value.is_a?(String)
+      @couch_lateral = value
+    end
+
+    # Sets the couch_longitudinal attribute.
+    #
+    def couch_longitudinal=(value)
+      raise ArgumentError, "Invalid argument 'value'. Expected String, got #{value.class}." unless value.is_a?(String)
+      @couch_longitudinal = value
+    end
+
+    # Sets the couch_angle attribute.
+    #
+    def couch_angle=(value)
+      raise ArgumentError, "Invalid argument 'value'. Expected String, got #{value.class}." unless value.is_a?(String)
+      @couch_angle = value
+    end
+
+    # Sets the couch_dir attribute.
+    #
+    def couch_dir=(value)
+      raise ArgumentError, "Invalid argument 'value'. Expected String, got #{value.class}." unless value.is_a?(String)
+      @couch_dir = value
+    end
+
+    # Sets the couch_pedestal attribute.
+    #
+    def couch_pedestal=(value)
+      raise ArgumentError, "Invalid argument 'value'. Expected String, got #{value.class}." unless value.is_a?(String)
+      @couch_pedestal = value
+    end
+
+    # Sets the couch_ped_dir attribute.
+    #
+    def couch_ped_dir=(value)
+      raise ArgumentError, "Invalid argument 'value'. Expected String, got #{value.class}." unless value.is_a?(String)
+      @couch_ped_dir = value
+    end
+
+  end
+
+end