Class: Receptacle

Inherits:
Asset show all
Includes:
Aliquot::Remover, 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, #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 Squishify

extended

Instance Method Details

#absolute_position_nameObject

Returns the name of the position (eg. A1) of the receptacle within the context of any tube-rack it may be contained within


320
321
322
# File 'app/models/receptacle.rb', line 320

def absolute_position_name
  racked_tube&.coordinate
end

#any_barcode_matching?(other_barcode) ⇒ Boolean

Returns:

  • (Boolean)

64
65
66
# File 'app/models/receptacle.rb', line 64

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

#api_asset_typeObject

Compatibility for v1 API maintains legacy 'type' for assets


305
306
307
# File 'app/models/receptacle.rb', line 305

def api_asset_type
  legacy_asset_type.tableize
end

#assign_tag2(tag) ⇒ Object


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

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)

263
264
265
266
267
268
269
270
# File 'app/models/receptacle.rb', line 263

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)

221
222
223
# File 'app/models/receptacle.rb', line 221

def been_through_qc?
  qc_state.present?
end

#compatible_qc_stateObject


211
212
213
# File 'app/models/receptacle.rb', line 211

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

#created_with_request_optionsObject


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

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

#detailsObject


300
301
302
# File 'app/models/receptacle.rb', line 300

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

#friendly_nameObject


314
315
316
# File 'app/models/receptacle.rb', line 314

def friendly_name
  labware&.friendly_name || id
end

#labware_comment_countObject


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

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

#latest_stock_metrics(_product, *_args) ⇒ Object

We only support wells for the time being


277
278
279
# File 'app/models/receptacle.rb', line 277

def latest_stock_metrics(_product, *_args)
  []
end

#legacy_asset_typeObject

Compatibility for v1 API maintains legacy 'type' for assets


310
311
312
# File 'app/models/receptacle.rb', line 310

def legacy_asset_type
  labware.sti_type
end

#library_informationObject


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

def library_information; end

#library_nameObject


296
297
298
# File 'app/models/receptacle.rb', line 296

def library_name
  labware.name
end

#library_typesObject

Library types are still just a string on aliquot.


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

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

#nameObject


284
285
286
287
288
# File 'app/models/receptacle.rb', line 284

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

#outer_request(submission_id) ⇒ Object


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

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

#primary_aliquot_if_uniqueObject


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

def primary_aliquot_if_unique
  primary_aliquot if aliquots.count == 1
end

All studies related to this asset


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

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

#roleObject


324
325
326
# File 'app/models/receptacle.rb', line 324

def role
  (requests_as_source.first || aliquot_requests.first).role
end

#set_as_library(force: false) ⇒ Object


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

def set_as_library(force: false)
  aliquots.each do |aliquot|
    aliquot.set_library(force: force)
    aliquot.save!
  end
end

#set_qc_state(state) ⇒ Object


215
216
217
218
219
# File 'app/models/receptacle.rb', line 215

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

#tag_rangeString?

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.


199
200
201
202
203
204
205
206
207
208
209
# File 'app/models/receptacle.rb', line 199

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

#total_comment_countObject


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

def total_comment_count
  comments.size + labware_comment_count
end

#update_aliquot_quality(suboptimal_quality) ⇒ Object


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

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

#update_from_qc(qc_result) ⇒ Object


290
291
292
# File 'app/models/receptacle.rb', line 290

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