rtp-connect 1.6 → 1.7

checksums.yaml

@@ -0,0 +1,15 @@
+---
+!binary "U0hBMQ==":
+  metadata.gz: !binary |-
+    ZDIyZThkNzk2OGI3OTdlMjY5MDk4MDQ2YmU5ODBhMTk3NTM2NzUwNg==
+  data.tar.gz: !binary |-
+    MzdjNjVjMTAwYjc2Yzg5YzI5ZTI1YjBiY2ZlNDA0MmIyYjE4MGNiNQ==
+SHA512:
+  metadata.gz: !binary |-
+    NzZlMGZmMDY3ODVkNjgyOGE2ZTMzMzZkNWMzMWUxMzU4MTk0NGIzY2UzZTYx
+    Y2RhODM1NDdlNzE0ZDZhN2JkOWRlYmZhZWUzNzI2MmQ5YzIwOTE2ZjYwZmYw
+    ZDZhZmRjZDc3NzAxNTU4ZDRiODdmYmEzMmRiMGYwMDI5MTRmNTY=
+  data.tar.gz: !binary |-
+    ZTYwNjBkOTI2NjNkOGFiNjdmMDJiMjU5NzNjZmNhOTQyYjVlNTFhNWI5NTIy
+    MTFmNWNhMTlmMzFmZjkxYjZlZTI4ZTVkNjA2OTkxYzY3ZTM0OGY2ZjRjZWY4
+    ODRhNDRiYTExODllYzQ1MWIyOTU5MWE0ZDYxYzNjMWJkOWQ2ZWM=

data/{CHANGELOG.rdoc → CHANGELOG.md}

@@ -1,6 +1,21 @@
-= 1.6
+# 1.7
 
-=== 12th December, 2013
+## 17th September 2014
+
+* Added a repair option for trying to fix records containing invalid CSV format (i.e. unescaped " characters).
+* Added an option for skipping unknown record types when reading an RTPConnect file (instead of raising an error).
+* Fixed an issue with writing records containing attributes of mixed encoding.
+* Added attributes for table top displacements in the Site Setup record (Mosaiq 2.6).
+* Upgraded test suite for Rspec 3.
+* Added support for the Extended Plan Definition record (Mosaiq 2.5).
+* Added option for ignoring invalid checksums.
+* Switched from RDoc to Markdown format.
+* Plan#to_dcm improvements.
+
+
+# 1.6
+
+## 12th December, 2013
 
 * Plan#to_dcm improvements:
   * Added support for VMAT by improving the handling of control point conversion.
@@ -17,9 +32,9 @@
   * Make sure that the last cumulative meterset weight exactly equals the final cumulative meterset weight.
 
 
-= 1.5
+# 1.5
 
-=== 24th October, 2013
+## 24th October, 2013
 
 * Added support for the Simulation Field record.
 * Bumped required Ruby version to 1.9.3.
@@ -42,25 +57,25 @@
     * Device Serial Number
 
 
-= 1.4
+# 1.4
 
-=== 10th April, 2013
+## 10th April, 2013
 
 * Support an extended ascii character set (ISO8859-1 encoding) for record values and file read/write.
 
 
-= 1.3
+# 1.3
 
-=== 12th October, 2012
+## 12th October, 2012
 
 * Added support for the updated ExtendedField record values introduced in Mosaiq 2.4.
 * Simply log a warning instead of raising an exception when reading a record with more values than excpected.
 * Allow reading (incomplete) records that contain the required values but not all the optional ones (instead of raising an exception).
 
 
-= 1.2
+# 1.2
 
-=== 13th July, 2012
+## 13th July, 2012
 
 * Converted documentation format from RDoc to YARD.
 * Added support for the Dose Tracking record.
@@ -68,9 +83,9 @@
 * Added the to_dcm conversion method for converting from RTP to DICOM.
 
 
-= 1.1
+# 1.1
 
-=== 18th April, 2012
+## 18th April, 2012
 
 * Added to_* methods for all records to complete the implementation of dynamic typing
 * Added comparison related methods to the record classes: #==, #eql? and #hash
@@ -80,9 +95,9 @@
 * Fixed an issue where reading a string with a single digit checksum would fail.
 
 
-= 1.0
+# 1.0
 
-=== 29th December, 2011
+## 29th December, 2011
 
 First public release.
 The library, although missing support for a number of record types, should be usable

data/Gemfile.lock

@@ -1,35 +1,41 @@
 PATH
   remote: .
   specs:
-    rtp-connect (1.6)
+    rtp-connect (1.7)
 
 GEM
   remote: http://www.rubygems.org/
   specs:
-    dicom (0.9.5)
-    diff-lcs (1.2.1)
-    metaclass (0.0.1)
-    mocha (0.13.2)
+    dicom (0.9.6)
+    diff-lcs (1.2.5)
+    metaclass (0.0.4)
+    mocha (1.1.0)
       metaclass (~> 0.0.1)
-    rake (0.9.6)
-    rspec (2.13.0)
-      rspec-core (~> 2.13.0)
-      rspec-expectations (~> 2.13.0)
-      rspec-mocks (~> 2.13.0)
-    rspec-core (2.13.0)
-    rspec-expectations (2.13.0)
-      diff-lcs (>= 1.1.3, < 2.0)
-    rspec-mocks (2.13.0)
-    yard (0.8.5)
+    rake (10.3.2)
+    redcarpet (3.1.2)
+    rspec (3.0.0)
+      rspec-core (~> 3.0.0)
+      rspec-expectations (~> 3.0.0)
+      rspec-mocks (~> 3.0.0)
+    rspec-core (3.0.4)
+      rspec-support (~> 3.0.0)
+    rspec-expectations (3.0.4)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.0.0)
+    rspec-mocks (3.0.4)
+      rspec-support (~> 3.0.0)
+    rspec-support (3.0.4)
+    yard (0.8.7.3)
 
 PLATFORMS
   x86-mingw32
 
 DEPENDENCIES
-  bundler (~> 1.3)
-  dicom (~> 0.9.5)
-  mocha (~> 0.13)
-  rake (~> 0.9.6)
-  rspec (~> 2.13)
+  bundler (~> 1.6)
+  dicom (~> 0.9, >= 0.9.6)
+  mocha (~> 1.1)
+  rake (~> 10.3)
+  redcarpet (~> 3.1)
+  rspec (~> 3.0)
   rtp-connect!
-  yard (~> 0.8.5)
+  yard (~> 0.8, >= 0.8.7)

data/{README.rdoc → README.md}

@@ -1,4 +1,4 @@
-= RTPConnect
+# 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
@@ -6,67 +6,78 @@ of treatment planning data. The library is written entirely in Ruby and has no
 external dependencies.
 
 
-== INSTALLATION
+## INSTALLATION
 
   gem install rtp-connect
 
 
-== REQUIREMENTS
+## REQUIREMENTS
 
 * Ruby 1.9.3 (or higher)
 
 
-== BASIC USAGE
+## BASIC USAGE
 
-=== Load & Include
+### Load & Include
 
-  require 'rtp-connect'
-  include RTP
+    require 'rtp-connect'
+    include RTP
 
-=== Read, modify and write
+### 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')
+    # 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 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_s
+    # 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_s
 
-=== Convert an RTP file to DICOM:
+### Fix invalid RTP files:
 
-  p = Plan.read('some_file.rtp')
-  dcm = p.to_dcm
-  dcm.write('rtplan.dcm')
+    # Read an RTP file containing invalid checksum(s):
+    rtp = Plan.read('invalid_crc.rtp', ignore_crc: true)
+    # Read an RTP file containing unknown record type(s):
+    rtp = Plan.read('custom.rtp', skip_unknown: true)
+    # Read an RTP file containing invalid CSV format:
+    rtp = Plan.read('invalid_csv.rtp', repair: true)
+    # Write a corrected RTP file:
+    rtp.write('valid.rtp')
 
-=== Log settings
+### Convert an RTP file to DICOM:
 
-  # 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')
+    p = Plan.read('some_file.rtp')
+    dcm = p.to_dcm
+    dcm.write('rtplan.dcm')
 
-=== Scripts
+### 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 comprehensive and useful examples, check out the scripts folder
 which contains various Ruby scripts that intends to show off real world
 usage scenarios of the RTPConnect library.
 
-=== IRB Tip
+### 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.
@@ -75,21 +86,23 @@ 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
+## RESOURCES
 
-* {Rubygems download}[https://rubygems.org/gems/rtp-connect]
-* {Documentation}[http://rubydoc.info/gems/rtp-connect/frames]
-* {Source code repository}[https://github.com/dicom/rtp-connect]
+* [Rubygems download](https://rubygems.org/gems/rtp-connect)
+* [Documentation](http://rubydoc.info/gems/rtp-connect/frames)
+* [Source code repository](https://github.com/dicom/rtp-connect)
 
 
-== RESTRICTIONS
+## RESTRICTIONS
 
-=== Supported records
+### Supported records
 
 * Plan definition [PLAN_DEF]
+* Extended plan definition [EXTENDED_PLAN_DEF]
 * Prescription site [RX_DEF]
 * Site setup [SITE_SETUP_DEF]
 * Simulation field [SIM_DEF]
@@ -98,9 +111,8 @@ Example:
 * Control point record [CONTROL_PT_DEF]
 * Dose tracking record [DOSE_DEF]
 
-=== Unsupported records
+### Unsupported records
 
-* Extended plan definition [EXTENDED_PLAN_DEF]
 * Document based treatment field [PDF_FIELD_DEF]
 * Multileaf collimator [MLC_DEF]
 * MLC shape [MLC_SHAPE_DEF]
@@ -109,9 +121,9 @@ Example:
 If you encounter an RTP file with an unsupported record type, please contact me.
 
 
-== COPYRIGHT
+## COPYRIGHT
 
-Copyright 2011-2013 Christoffer Lervåg
+Copyright 2011-2014 Christoffer Lervåg
 
 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
@@ -127,7 +139,7 @@ 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
+## ABOUT THE AUTHOR
 
 * Name: Christoffer Lervåg
 * Location: Norway

data/lib/rtp-connect.rb

@@ -6,6 +6,7 @@ require_relative 'rtp-connect/logging'
 require_relative 'rtp-connect/record'
 # Core library:
 require_relative 'rtp-connect/plan'
+require_relative 'rtp-connect/extended_plan'
 require_relative 'rtp-connect/plan_to_dcm'
 require_relative 'rtp-connect/prescription'
 require_relative 'rtp-connect/site_setup'

data/lib/rtp-connect/constants.rb

@@ -42,6 +42,7 @@ module RTP
   # Pairs of RTPConnect keywords and parse method names.
   PARSE_METHOD = {
     "PLAN_DEF" => :plan_definition,
+    "EXTENDED_PLAN_DEF" => :extended_plan,
     "RX_DEF" => :prescription_site,
     "SITE_SETUP_DEF" => :site_setup,
     "SIM_DEF" => :simulation_field,

data/lib/rtp-connect/control_point.rb

@@ -56,50 +56,8 @@ module RTP
     # @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
-      low_limit = 233
-      high_limit = 233
-      raise ArgumentError, "Invalid argument 'string': Expected at least #{low_limit} elements, got #{values.length}." if values.length < low_limit
-      RTP.logger.warn "The number of elements (#{values.length}) for this ControlPoint record exceeds the known number of data items for this record (#{high_limit}). This may indicate an invalid record or that the RTP format has recently been expanded with new items." if values.length > high_limit
       cp = self.new(parent)
-      # Assign the values to attributes:
-      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[-1]
-      return cp
+      cp.load(string)
     end
 
     # Creates a new ControlPoint.
@@ -107,14 +65,51 @@ module RTP
     # @param [Record] parent a record which is used to determine the proper parent of this instance
     #
     def initialize(parent)
+      super('CONTROL_PT_DEF', 233, 233)
       # Child:
       @mlc_shape = nil
       # Parent relation (may get more than one type of record here):
       @parent = get_parent(parent.to_record, Field)
       @parent.add_control_point(self)
-      @keyword = 'CONTROL_PT_DEF'
       @mlc_lp_a = Array.new(100)
       @mlc_lp_b = Array.new(100)
+      @attributes = [
+        # Required:
+        :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
 
     # Checks for equality.
@@ -145,51 +140,67 @@ module RTP
 
     # Converts the collimator_x1 attribute to proper DICOM format.
     #
+    # @param [Symbol] scale if set, relevant device parameters are converted from a native readout format to IEC1217 (supported values are :elekta & :varian)
     # @return [Float] the DICOM-formatted collimator_x1 attribute
     #
-    def dcm_collimator_x1
-      attribute = (scale_convertion? ? :collimator_y1 : :collimator_x1)
-      target = (@field_x_mode && !@field_x_mode.empty? ? self : @parent)
-      target.send(attribute).to_f * 10 * scale_factor
+    def dcm_collimator_x1(scale=nil)
+      coeff = 1
+      axis = :x
+      if scale == :elekta
+        axis = :y
+        coeff = -1
+      elsif scale == :varian
+        coeff = -1
+      end
+      dcm_collimator1(axis, coeff)
     end
 
     # Converts the collimator_x2 attribute to proper DICOM format.
     #
+    # @param [Symbol] scale if set, relevant device parameters are converted from native readout format to IEC1217 (supported values are :elekta & :varian)
     # @return [Float] the DICOM-formatted collimator_x2 attribute
     #
-    def dcm_collimator_x2
-      attribute = (scale_convertion? ? :collimator_y2 : :collimator_x2)
-      target = (@field_x_mode && !@field_x_mode.empty? ? self : @parent)
-      target.send(attribute).to_f * 10
+    def dcm_collimator_x2(scale=nil)
+      axis = (scale == :elekta ? :y : :x)
+      dcm_collimator2(axis, coeff=1)
     end
 
     # Converts the collimator_y1 attribute to proper DICOM format.
     #
+    # @param [Symbol] scale if set, relevant device parameters are converted from native readout format to IEC1217 (supported values are :elekta & :varian)
     # @return [Float] the DICOM-formatted collimator_y1 attribute
     #
-    def dcm_collimator_y1
-      attribute = (scale_convertion? ? :collimator_x1 : :collimator_y1)
-      target = (@field_y_mode && !@field_y_mode.empty? ? self : @parent)
-      target.send(attribute).to_f * 10 * scale_factor
+    def dcm_collimator_y1(scale=nil)
+      coeff = 1
+      axis = :y
+      if scale == :elekta
+        axis = :x
+        coeff = -1
+      elsif scale == :varian
+        coeff = -1
+      end
+      dcm_collimator1(axis, coeff)
     end
 
     # Converts the collimator_y2 attribute to proper DICOM format.
     #
+    # @param [Symbol] scale if set, relevant device parameters are converted from native readout format to IEC1217 (supported values are :elekta & :varian)
     # @return [Float] the DICOM-formatted collimator_y2 attribute
     #
-    def dcm_collimator_y2
-      attribute = (scale_convertion? ? :collimator_x2 : :collimator_y2)
-      target = (@field_y_mode && !@field_y_mode.empty? ? self : @parent)
-      target.send(attribute).to_f * 10
+    def dcm_collimator_y2(scale=nil)
+      axis = (scale == :elekta ? :x : :y)
+      dcm_collimator2(axis, coeff=1)
     end
 
     # Converts the mlc_lp_a & mlc_lp_b attributes to a proper DICOM formatted string.
     #
+    # @param [Symbol] scale if set, relevant device parameters are converted from native readout format to IEC1217 (supported values are :elekta & :varian)
     # @return [String] the DICOM-formatted leaf pair positions
     #
-    def dcm_mlc_positions
+    def dcm_mlc_positions(scale=nil)
+      coeff = (scale == :elekta ? -1 : 1)
       # As with the collimators, the first side (1/a) may need scale invertion:
-      pos_a = @mlc_lp_a.collect{|p| (p.to_f * 10 * scale_factor).round(1) unless p.empty?}.compact
+      pos_a = @mlc_lp_a.collect{|p| (p.to_f * 10 * coeff).round(1) unless p.empty?}.compact
       pos_b = @mlc_lp_b.collect{|p| (p.to_f * 10).round(1) unless p.empty?}.compact
       (pos_a + pos_b).join("\\")
     end
@@ -219,7 +230,7 @@ module RTP
     # @return [Array<String>] an array of attributes (in the same order as they appear in the RTP string)
     #
     def values
-      return [
+      [
         @keyword,
         @field_id,
         @mlc_type,
@@ -289,9 +300,7 @@ module RTP
     # @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.strip}
+      @mlc_lp_a = array.to_a.validate_and_process(100)
     end
 
     # Sets the mlc_lp_b attribute.
@@ -301,21 +310,7 @@ module RTP
     # @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.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"
-      @keyword = value
+      @mlc_lp_b = array.to_a.validate_and_process(100)
     end
 
     # Sets the field_id attribute.
@@ -577,31 +572,78 @@ module RTP
     #
     alias_method :state, :values
 
-    # Checks whether the contents of the this record indicates that scale
-    # convertion is to be applied. This convertion entails converting a value
-    # from IEC1217 format to the target machine's native readout format.
-    # Note that the scope of this scale conversion is not precisely known (the
-    # current implementation is based on a few observations made from a single
-    # RTP file).
+    # Converts the collimator attribute to proper DICOM format.
     #
-    # @return [Boolean] true if the scale convention attribute indicates scale convertion
+    # @param [Symbol] axis a representation for the axis of interest (x or y)
+    # @param [Integer] coeff a coeffecient (of -1 or 1) which the attribute is multiplied with
+    # @return [Float] the DICOM-formatted collimator attribute
     #
-    def scale_convertion?
-      # A scale convention of 1 means that geometric parameters are represented
-      # in the target machine's native readout format, as opposed to the IEC 1217
-      # convention. The consequences of this is not totally clear, but at least for
-      # an Elekta device, there are a number of convertions which seems to be indicated.
-      @scale_convention.to_i == 1 ? true : false
+    def dcm_collimator1(axis, coeff)
+      mode = self.send("field_#{axis}_mode")
+      if mode && !mode.empty?
+        target = self
+      else
+        target = @parent
+      end
+      target.send("collimator_#{axis}1").to_f * 10 * coeff
     end
 
-    # Gives a factor used for scale convertion, which depends on the
-    # 'scale_convention' attribute.
+    # Converts the collimator attribute to proper DICOM format.
     #
-    # @param [Numerical] value the value to process
-    # @return [Numerical] the scale converted value
+    # @param [Symbol] axis a representation for the axis of interest (x or y)
+    # @param [Integer] coeff a coeffecient (of -1 or 1) which the attribute is multiplied with
+    # @return [Float] the DICOM-formatted collimator attribute
     #
-    def scale_factor
-      scale_convertion? ? -1 : 1
+    def dcm_collimator2(axis, coeff)
+      mode = self.send("field_#{axis}_mode")
+      if mode && !mode.empty?
+        target = self
+      else
+        target = @parent
+      end
+      target.send("collimator_#{axis}2").to_f * 10 * coeff
+    end
+
+    # Sets the attributes of the record instance.
+    #
+    # @param [Array<String>] values the record attributes (as parsed from a record string)
+    #
+    def set_attributes(values)
+      self.keyword = values[0]
+      @field_id = values[1]
+      @mlc_type = values[2]
+      @mlc_leaves = values[3]
+      @total_control_points = values[4]
+      @control_pt_number = values[5]
+      @mu_convention = values[6]
+      @monitor_units = values[7]
+      @wedge_position = values[8]
+      @energy = values[9]
+      @doserate = values[10]
+      @ssd = values[11]
+      @scale_convention = values[12]
+      @gantry_angle = values[13]
+      @gantry_dir = values[14]
+      @collimator_angle = values[15]
+      @collimator_dir = values[16]
+      @field_x_mode = values[17]
+      @field_x = values[18]
+      @collimator_x1 = values[19]
+      @collimator_x2 = values[20]
+      @field_y_mode = values[21]
+      @field_y = values[22]
+      @collimator_y1 = values[23]
+      @collimator_y2 = values[24]
+      @couch_vertical = values[25]
+      @couch_lateral = values[26]
+      @couch_longitudinal = values[27]
+      @couch_angle = values[28]
+      @couch_dir = values[29]
+      @couch_pedestal = values[30]
+      @couch_ped_dir = values[31]
+      @mlc_lp_a = [*values[32..131]]
+      @mlc_lp_b = [*values[132..231]]
+      @crc = values[-1]
     end
 
   end