Class: Receptacle

Inherits:
Asset show all
Includes:
Aliquot::Remover, Asset::ReceptacleAssociations, Commentable, StudyReport::AssetDetails, Transfer::State, Uuid::Uuidable
Defined in:
app/models/receptacle.rb

Overview

A receptacle is a container for aliquots, they are associated with Labware, which represents the physical object which moves round the lab. A Labware may have a single Receptacle, such as in the case of a Tube or multiple, in the case of a Plate. Work can be requested on a particular receptacle.

Direct Known Subclasses

Lane, Qc, Well

Defined Under Namespace

Classes: Qc

Constant Summary collapse

QC_STATE_ALIASES = 
{
  'passed' => 'pass',
  'failed' => 'fail'
}.freeze

Constants included from Transfer::State

Transfer::State::ALL_STATES

Instance Method Summary collapse

Methods included from StudyReport::AssetDetails

#qc_report

Methods included from Aliquot::Remover

#on_downstream_aliquots, #process_aliquots, #remove_downstream_aliquots, #remove_matching_aliquots

Methods included from Transfer::State

#default_state, #state, #state_from, state_helper

Methods included from Commentable

#after_comment_addition

Methods included from Uuid::Uuidable

included, #unsaved_uuid!, #uuid

Methods inherited from Asset

#add_parent, #ancestor_of_purpose, #asset_type_for_request_types, #assign_relationships, #barcode_number, #compatible_purposes, #contained_samples, #external_identifier, #generate_barcode, #get_qc_result_value_for, #has_stock_asset?, #label, #label=, #original_stock_plates, #prefix, #printable?, #printable_target, #register_stock!, #request_types, #role, #source_plate, #spiked_in_buffer, #summary_hash, #type

Methods included from EventfulRecord

#has_many_events, #has_many_lab_events, #has_one_event_with_family

Methods included from Event::PlateEvents

#event_date, #fluidigm_stamp_date, #gel_qc_date, #pico_date, #qc_started_date, #sequenom_stamp_date

Methods inherited from ApplicationRecord

convert_labware_to_receptacle_for, find_by_id_or_name, find_by_id_or_name!

Methods included from Warren::BroadcastMessages

#broadcast, included, #queue_associated_for_broadcast, #queue_for_broadcast, #warren

Instance Method Details

#any_barcode_matching?(other_barcode) ⇒ Boolean

Returns:

  • (Boolean) 

48
49
50
 
# File 'app/models/receptacle.rb', line 48

def any_barcode_matching?(other_barcode)
  barcodes.any? { |barcode| barcode =~ other_barcode }
end

#api_asset_type ⇒ Object

Compatibility for v1 API maintains legacy 'type' for assets


253
254
255
 
# File 'app/models/receptacle.rb', line 253

def api_asset_type
  legacy_asset_type.tableize
end

#assign_tag2(tag) ⇒ Object 


179
180
181
182
183
184
 
# File 'app/models/receptacle.rb', line 179

def assign_tag2(tag)
  aliquots.each do |aliquot|
    aliquot.tag2 = tag
    aliquot.save!
  end
end

#attach_tag(tag, tag2 = nil) ⇒ Object Also known as: attach_tags

Raises:

  • (StandardError) 

211
212
213
214
215
216
217
218
 
# File 'app/models/receptacle.rb', line 211

def attach_tag(tag, tag2 = nil)
  tags = { tag: tag, tag2: tag2 }.compact
  return if tags.empty?
  raise StandardError, 'Cannot tag an empty asset'   if aliquots.empty?
  raise StandardError, 'Cannot tag multiple samples' if aliquots.size > 1

  aliquots.first.update!(tags)
end

#been_through_qc? ⇒ Boolean

Returns:

  • (Boolean) 

169
170
171
 
# File 'app/models/receptacle.rb', line 169

def been_through_qc?
  qc_state.present?
end

#compatible_qc_state ⇒ Object 


159
160
161
 
# File 'app/models/receptacle.rb', line 159

def compatible_qc_state
  QC_STATE_ALIASES.fetch(qc_state, qc_state) || ''
end

#created_with_request_options ⇒ Object 


186
187
188
 
# File 'app/models/receptacle.rb', line 186

def created_with_request_options
  aliquots.first&.created_with_request_options || {}
end

#details ⇒ Object 


248
249
250
 
# File 'app/models/receptacle.rb', line 248

def details
  labware.try(:details).presence || 'Not on labware'
end

#friendly_name ⇒ Object 


262
263
264
 
# File 'app/models/receptacle.rb', line 262

def friendly_name
  labware&.friendly_name || id
end

#labware_comment_count ⇒ Object 


137
138
139
 
# File 'app/models/receptacle.rb', line 137

def labware_comment_count
  labware&.comments&.size || 0
end

#latest_stock_metrics(_product, *_args) ⇒ Object

We only support wells for the time being


225
226
227
 
# File 'app/models/receptacle.rb', line 225

def latest_stock_metrics(_product, *_args)
  []
end

#legacy_asset_type ⇒ Object

Compatibility for v1 API maintains legacy 'type' for assets


258
259
260
 
# File 'app/models/receptacle.rb', line 258

def legacy_asset_type
  labware.sti_type
end

#library_information ⇒ Object 


177
 
# File 'app/models/receptacle.rb', line 177

def library_information; end

#library_name ⇒ Object 


244
245
246
 
# File 'app/models/receptacle.rb', line 244

def library_name
  labware.name
end

#library_types ⇒ Object

Library types are still just a string on aliquot.


191
192
193
 
# File 'app/models/receptacle.rb', line 191

def library_types
  aliquots.pluck(:library_type).uniq
end

#name ⇒ Object 


232
233
234
235
236
 
# File 'app/models/receptacle.rb', line 232

def name
  labware_name = labware.present? ? labware.try(:name) : '(not on a labware)'
  labware_name ||= labware.display_name # In the even the labware is barcodeless (ie strip tubes) use its name
  labware_name
end

#outer_request(submission_id) ⇒ Object 


202
203
204
 
# File 'app/models/receptacle.rb', line 202

def outer_request(submission_id)
  transfer_requests_as_target.find_by(submission_id: submission_id).try(:outer_request)
end

#primary_aliquot_if_unique ⇒ Object 


173
174
175
 
# File 'app/models/receptacle.rb', line 173

def primary_aliquot_if_unique
  primary_aliquot if aliquots.count == 1
end

#related_studies ⇒ Object

All studies related to this asset


207
208
209
 
# File 'app/models/receptacle.rb', line 207

def related_studies
  (ordered_studies + studies).compact.uniq
end

#set_as_library ⇒ Object 


195
196
197
198
199
200
 
# File 'app/models/receptacle.rb', line 195

def set_as_library
  aliquots.each do |aliquot|
    aliquot.set_library
    aliquot.save!
  end
end

#set_qc_state(state) ⇒ Object 


163
164
165
166
167
 
# File 'app/models/receptacle.rb', line 163

def set_qc_state(state)
  self.qc_state = QC_STATE_ALIASES.key(state) || state
  save
  set_external_release(qc_state)
end

#tag_range ⇒ String?

Returns the map_id of the first and last tag in an asset eg 1-96. Caution: Used on barcode labels. Avoid using elsewhere as makes assumptions

about tag behaviour which may change shortly.

Returns:

  • (String, nil) —

    Returns nil is no tags, the map_id is a single tag, or the first and last map id separated by a hyphen if multiple tags.


150
151
152
153
154
155
156
157
 
# File 'app/models/receptacle.rb', line 150

def tag_range
  map_ids = tags.order(:map_id).pluck(:map_id)
  case map_ids.length
  when 0; then nil
  when 1; then map_ids.first
  else "#{map_ids.first}-#{map_ids.last}"
  end
end

#total_comment_count ⇒ Object 


133
134
135
 
# File 'app/models/receptacle.rb', line 133

def total_comment_count
  comments.size + labware_comment_count
end

#update_aliquot_quality(suboptimal_quality) ⇒ Object 


126
127
128
129
 
# File 'app/models/receptacle.rb', line 126

def update_aliquot_quality(suboptimal_quality)
  aliquots.each { |a| a.update_quality(suboptimal_quality) }
  true
end

#update_from_qc(qc_result) ⇒ Object 


238
239
240
 
# File 'app/models/receptacle.rb', line 238

def update_from_qc(qc_result)
  Tube::AttributeUpdater.update(self, qc_result)
end