rtp-connect 1.1 → 1.2

data/Gemfile

@@ -0,0 +1,3 @@
+source "http://www.rubygems.org"
+
+gemspec

data/Gemfile.lock

@@ -0,0 +1,35 @@
+PATH
+  remote: .
+  specs:
+    rtp-connect (1.1)
+
+GEM
+  remote: http://www.rubygems.org/
+  specs:
+    dicom (0.9.3)
+    diff-lcs (1.1.3)
+    metaclass (0.0.1)
+    mocha (0.12.0)
+      metaclass (~> 0.0.1)
+    rake (0.9.2.2)
+    rspec (2.11.0)
+      rspec-core (~> 2.11.0)
+      rspec-expectations (~> 2.11.0)
+      rspec-mocks (~> 2.11.0)
+    rspec-core (2.11.0)
+    rspec-expectations (2.11.1)
+      diff-lcs (~> 1.1.3)
+    rspec-mocks (2.11.1)
+    yard (0.8.2.1)
+
+PLATFORMS
+  x86-mingw32
+
+DEPENDENCIES
+  bundler (>= 1.0.0)
+  dicom (>= 0.9.3)
+  mocha (>= 0.10.5)
+  rake (>= 0.9.2.2)
+  rspec (>= 2.9.0)
+  rtp-connect!
+  yard (>= 0.8.2)

data/README.rdoc

@@ -26,23 +26,29 @@ external dependencies.
 === Read, modify and write
 
   # Read file:
-  rtp = Plan.read("some_file.rtp")
+  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"
+  rtp.patient_last_name = 'Anonymous'
   # Write to file:
-  rtp.write("new_file.rtp")
+  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"
+  rtp.patient_id = '12345'
   # Export the instance to an RTP string (with CRC):
   output = rtp.to_s
 
+=== Convert an RTP file to DICOM:
+
+  p = Plan.read('some_file.rtp')
+  dcm = p.to_dcm
+  dcm.write('rtplan.dcm')
+
 === Log settings
 
   # Change the log level so that only error messages are displayed:
@@ -69,7 +75,7 @@ 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
+  rtp = Plan.read('some_file.rtp') ;0
 
 
 == RESOURCES
@@ -89,6 +95,7 @@ Example:
 * Treatment field [FIELD_DEF]
 * Extended treatment field [EXTENDED_FIELD_DEF]
 * Control point record [CONTROL_PT_DEF]
+* Dose tracking record [DOSE_DEF]
 
 === Unsupported records
 
@@ -96,7 +103,6 @@ Example:
 * 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.

data/lib/rtp-connect.rb

@@ -1,23 +1,25 @@
-# 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'
-
-# Load the CSV library:
+# 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/plan_to_dcm'
+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'
+require_relative 'rtp-connect/dose_tracking'
+# 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'
+
+# Load the CSV library:
 require 'csv'

data/lib/rtp-connect/constants.rb

@@ -1,58 +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,
-  }
-
+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

@@ -2,10 +2,9 @@ module RTP
 
   # The ControlPoint class.
   #
-  # === Relations
-  #
-  # * Parent: Field
-  # * Children: MLCShape
+  # @note Relations:
+  #   * Parent: Field
+  #   * Children: none
   #
   class ControlPoint < Record
 
@@ -51,60 +50,58 @@ module RTP
 
     # 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.
+    # @param [#to_s] string the control point definition record string line
+    # @param [Record] parent a record which is used to determine the proper parent of this instance
+    # @return [ControlPoint] the created ControlPoint instance
+    # @raise [ArgumentError] if given a string containing an invalid number of elements
     #
     def self.load(string, parent)
       # Get the quote-less values:
       values = string.to_s.values
       raise ArgumentError, "Invalid argument 'string': Expected exactly 233 elements, got #{values.length}." unless values.length == 233
-      f = self.new(parent)
+      cp = 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
+      cp.keyword = values[0]
+      cp.field_id = values[1]
+      cp.mlc_type = values[2]
+      cp.mlc_leaves = values[3]
+      cp.total_control_points = values[4]
+      cp.control_pt_number = values[5]
+      cp.mu_convention = values[6]
+      cp.monitor_units = values[7]
+      cp.wedge_position = values[8]
+      cp.energy = values[9]
+      cp.doserate = values[10]
+      cp.ssd = values[11]
+      cp.scale_convention = values[12]
+      cp.gantry_angle = values[13]
+      cp.gantry_dir = values[14]
+      cp.collimator_angle = values[15]
+      cp.collimator_dir = values[16]
+      cp.field_x_mode = values[17]
+      cp.field_x = values[18]
+      cp.collimator_x1 = values[19]
+      cp.collimator_x2 = values[20]
+      cp.field_y_mode = values[21]
+      cp.field_y = values[22]
+      cp.collimator_y1 = values[23]
+      cp.collimator_y2 = values[24]
+      cp.couch_vertical = values[25]
+      cp.couch_lateral = values[26]
+      cp.couch_longitudinal = values[27]
+      cp.couch_angle = values[28]
+      cp.couch_dir = values[29]
+      cp.couch_pedestal = values[30]
+      cp.couch_ped_dir = values[31]
+      cp.mlc_lp_a = [*values[32..131]]
+      cp.mlc_lp_b = [*values[132..231]]
+      cp.crc = values[232]
+      return cp
     end
 
     # Creates a new ControlPoint.
     #
-    # === Parameters
-    #
-    # * <tt>parent</tt> -- A Record which is used to determine the proper parent of this instance.
+    # @param [Record] parent a record which is used to determine the proper parent of this instance
     #
     def initialize(parent)
       # Child:
@@ -117,7 +114,13 @@ module RTP
       @mlc_lp_b = Array.new(100)
     end
 
-    # Returns true if the argument is an instance with attributes equal to self.
+    # Checks for equality.
+    #
+    # Other and self are considered equivalent if they are
+    # of compatible types and their attributes are equivalent.
+    #
+    # @param other an object to be compared with self.
+    # @return [Boolean] true if self and other are considered equivalent
     #
     def ==(other)
       if other.respond_to?(:to_control_point)
@@ -127,23 +130,39 @@ module RTP
 
     alias_method :eql?, :==
 
-    # 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.
+    # As of now, gives an empty array. However, by definition, this record may
+    # have an mlc shape record as child, but this is not implemented yet.
+    #
+    # @return [Array] an emtpy array
     #
     def children
       #return [@mlc_shape]
       return Array.new
     end
 
-    # Generates a Fixnum hash value for this instance.
+    # Computes a hash code for this object.
+    #
+    # @note Two objects with the same attributes will have the same hash code.
+    #
+    # @return [Fixnum] the object's hash code
     #
     def hash
       state.hash
     end
 
-    # Returns the values of this instance in an array.
-    # The values does not include the CRC.
+    # Gives the index of this ControlPoint
+    # (i.e. its index among the control points belonging to the parent Field).
+    #
+    # @return [Fixnum] the control point's index
+    #
+    def index
+      @parent.control_points.index(self)
+    end
+
+    # Collects the values (attributes) of this instance.
+    #
+    # @note The CRC is not considered part of the actual values and is excluded.
+    # @return [Array<String>] an array of attributes (in the same order as they appear in the RTP string)
     #
     def values
       return [
@@ -186,13 +205,17 @@ module RTP
 
     # Returns self.
     #
+    # @return [ControlPoint] self
+    #
     def to_control_point
       self
     end
 
-    # Writes the ControlPoint object + any hiearchy of child objects,
+    # Encodes the ControlPoint object + any hiearchy of child objects,
     # to a properly formatted RTPConnect ascii string.
     #
+    # @return [String] an RTP string with a single or multiple lines/records
+    #
     def to_s
       str = encode
       if children
@@ -205,34 +228,36 @@ module RTP
 
     alias :to_str :to_s
 
-    # Sets the mlc_a attribute.
-    #
-    # === Notes
+    # Sets the mlc_lp_a attribute.
     #
-    # As opposed to the ordinary (string) attributes, this attribute
-    # contains an array holding all 100 MLC leaf 'A' string values.
+    # @note As opposed to the ordinary (string) attributes, this attribute
+    #   contains an array holding all 100 MLC leaf 'A' string values.
+    # @param [Array<nil, #to_s>] array the new attribute values
     #
     def mlc_lp_a=(array)
       array = array.to_a
       raise ArgumentError, "Invalid argument 'array'. Expected length 100, got #{array.length}." unless array.length == 100
-      @mlc_lp_a = array.collect! {|e| e && e.to_s}
+      @mlc_lp_a = array.collect! {|e| e && e.to_s.strip}
     end
 
-    # Sets the mlc_b attribute.
+    # Sets the mlc_lp_b attribute.
     #
-    # === Notes
-    #
-    # As opposed to the ordinary (string) attributes, this attribute
-    # contains an array holding all 100 MLC leaf 'A' string values.
+    # @note As opposed to the ordinary (string) attributes, this attribute
+    #   contains an array holding all 100 MLC leaf 'B' string values.
+    # @param [Array<nil, #to_s>] array the new attribute values
     #
     def mlc_lp_b=(array)
       array = array.to_a
       raise ArgumentError, "Invalid argument 'array'. Expected length 100, got #{array.length}." unless array.length == 100
-      @mlc_lp_b = array.collect! {|e| e && e.to_s}
+      @mlc_lp_b = array.collect! {|e| e && e.to_s.strip}
     end
 
     # Sets the keyword attribute.
     #
+    # @note Since only a specific string is accepted, this is more of an argument check than a traditional setter method
+    # @param [#to_s] value the new attribute value
+    # @raise [ArgumentError] if given an unexpected keyword
+    #
     def keyword=(value)
       value = value.to_s.upcase
       raise ArgumentError, "Invalid keyword. Expected 'CONTROL_PT_DEF', got #{value}." unless value == "CONTROL_PT_DEF"
@@ -241,186 +266,248 @@ module RTP
 
     # Sets the field_id attribute.
     #
+    # @param [nil, #to_s] value the new attribute value
+    #
     def field_id=(value)
       @field_id = value && value.to_s
     end
 
     # Sets the mlc_type attribute.
     #
+    # @param [nil, #to_s] value the new attribute value
+    #
     def mlc_type=(value)
       @mlc_type = value && value.to_s
     end
 
     # Sets the mlc_leaves attribute.
     #
+    # @param [nil, #to_s] value the new attribute value
+    #
     def mlc_leaves=(value)
-      @mlc_leaves = value && value.to_s
+      @mlc_leaves = value && value.to_s.strip
     end
 
     # Sets the total_control_points attribute.
     #
+    # @param [nil, #to_s] value the new attribute value
+    #
     def total_control_points=(value)
-      @total_control_points = value && value.to_s
+      @total_control_points = value && value.to_s.strip
     end
 
     # Sets the control_pt_number attribute.
     #
+    # @param [nil, #to_s] value the new attribute value
+    #
     def control_pt_number=(value)
-      @control_pt_number = value && value.to_s
+      @control_pt_number = value && value.to_s.strip
     end
 
     # Sets the mu_convention attribute.
     #
+    # @param [nil, #to_s] value the new attribute value
+    #
     def mu_convention=(value)
       @mu_convention = value && value.to_s
     end
 
     # Sets the monitor_units attribute.
     #
+    # @param [nil, #to_s] value the new attribute value
+    #
     def monitor_units=(value)
       @monitor_units = value && value.to_s
     end
 
     # Sets the wedge_position attribute.
     #
+    # @param [nil, #to_s] value the new attribute value
+    #
     def wedge_position=(value)
       @wedge_position = value && value.to_s
     end
 
     # Sets the energy attribute.
     #
+    # @param [nil, #to_s] value the new attribute value
+    #
     def energy=(value)
       @energy = value && value.to_s
     end
 
     # Sets the doserate attribute.
     #
+    # @param [nil, #to_s] value the new attribute value
+    #
     def doserate=(value)
-      @doserate = value && value.to_s
+      @doserate = value && value.to_s.strip
     end
 
     # Sets the ssd attribute.
     #
+    # @param [nil, #to_s] value the new attribute value
+    #
     def ssd=(value)
       @ssd = value && value.to_s
     end
 
     # Sets the scale_convention attribute.
     #
+    # @param [nil, #to_s] value the new attribute value
+    #
     def scale_convention=(value)
       @scale_convention = value && value.to_s
     end
 
     # Sets the gantry_angle attribute.
     #
+    # @param [nil, #to_s] value the new attribute value
+    #
     def gantry_angle=(value)
-      @gantry_angle = value && value.to_s
+      @gantry_angle = value && value.to_s.strip
     end
 
     # Sets the gantry_dir attribute.
     #
+    # @param [nil, #to_s] value the new attribute value
+    #
     def gantry_dir=(value)
       @gantry_dir = value && value.to_s
     end
 
     # Sets the collimator_angle attribute.
     #
+    # @param [nil, #to_s] value the new attribute value
+    #
     def collimator_angle=(value)
-      @collimator_angle = value && value.to_s
+      @collimator_angle = value && value.to_s.strip
     end
 
     # Sets the collimator_dir attribute.
     #
+    # @param [nil, #to_s] value the new attribute value
+    #
     def collimator_dir=(value)
       @collimator_dir = value && value.to_s
     end
 
     # Sets the field_x_mode attribute.
     #
+    # @param [nil, #to_s] value the new attribute value
+    #
     def field_x_mode=(value)
       @field_x_mode = value && value.to_s
     end
 
     # Sets the field_x attribute.
     #
+    # @param [nil, #to_s] value the new attribute value
+    #
     def field_x=(value)
-      @field_x = value && value.to_s
+      @field_x = value && value.to_s.strip
     end
 
     # Sets the collimator_x1 attribute.
     #
+    # @param [nil, #to_s] value the new attribute value
+    #
     def collimator_x1=(value)
-      @collimator_x1 = value && value.to_s
+      @collimator_x1 = value && value.to_s.strip
     end
 
     # Sets the collimator_x2 attribute.
     #
+    # @param [nil, #to_s] value the new attribute value
+    #
     def collimator_x2=(value)
-      @collimator_x2 = value && value.to_s
+      @collimator_x2 = value && value.to_s.strip
     end
 
     # Sets the field_y_mode attribute.
     #
+    # @param [nil, #to_s] value the new attribute value
+    #
     def field_y_mode=(value)
       @field_y_mode = value && value.to_s
     end
 
     # Sets the field_y attribute.
     #
+    # @param [nil, #to_s] value the new attribute value
+    #
     def field_y=(value)
-      @field_y = value && value.to_s
+      @field_y = value && value.to_s.strip
     end
 
     # Sets the collimator_y1 attribute.
     #
+    # @param [nil, #to_s] value the new attribute value
+    #
     def collimator_y1=(value)
-      @collimator_y1 = value && value.to_s
+      @collimator_y1 = value && value.to_s.strip
     end
 
     # Sets the collimator_y2 attribute.
     #
+    # @param [nil, #to_s] value the new attribute value
+    #
     def collimator_y2=(value)
-      @collimator_y2 = value && value.to_s
+      @collimator_y2 = value && value.to_s.strip
     end
 
     # Sets the couch_vertical attribute.
     #
+    # @param [nil, #to_s] value the new attribute value
+    #
     def couch_vertical=(value)
-      @couch_vertical = value && value.to_s
+      @couch_vertical = value && value.to_s.strip
     end
 
     # Sets the couch_lateral attribute.
     #
+    # @param [nil, #to_s] value the new attribute value
+    #
     def couch_lateral=(value)
-      @couch_lateral = value && value.to_s
+      @couch_lateral = value && value.to_s.strip
     end
 
     # Sets the couch_longitudinal attribute.
     #
+    # @param [nil, #to_s] value the new attribute value
+    #
     def couch_longitudinal=(value)
-      @couch_longitudinal = value && value.to_s
+      @couch_longitudinal = value && value.to_s.strip
     end
 
     # Sets the couch_angle attribute.
     #
+    # @param [nil, #to_s] value the new attribute value
+    #
     def couch_angle=(value)
-      @couch_angle = value && value.to_s
+      @couch_angle = value && value.to_s.strip
     end
 
     # Sets the couch_dir attribute.
     #
+    # @param [nil, #to_s] value the new attribute value
+    #
     def couch_dir=(value)
       @couch_dir = value && value.to_s
     end
 
     # Sets the couch_pedestal attribute.
     #
+    # @param [nil, #to_s] value the new attribute value
+    #
     def couch_pedestal=(value)
-      @couch_pedestal = value && value.to_s
+      @couch_pedestal = value && value.to_s.strip
     end
 
     # Sets the couch_ped_dir attribute.
     #
+    # @param [nil, #to_s] value the new attribute value
+    #
     def couch_ped_dir=(value)
       @couch_ped_dir = value && value.to_s
     end
@@ -429,7 +516,10 @@ module RTP
     private
 
 
-    # Returns the attributes of this instance in an array (for comparison purposes).
+    # Collects the attributes of this instance.
+    #
+    # @note The CRC is not considered part of the attributes of interest and is excluded
+    # @return [Array<String>] an array of attributes
     #
     alias_method :state, :values