DPL-823 [Part 1 - download] Import PBMC pool plates into Sequencescape

app/controllers/sdb/sample_manifests_controller.rb

@@ -37,6 +37,7 @@ def show
     @study_id = @sample_manifest.study_id
     @samples = @sample_manifest.samples.paginate(page: params[:page])
   end
+
   def new # rubocop:todo Metrics/AbcSize
     params[:only_first_label] ||= false
     @sample_manifest = SampleManifest.new(new_manifest_params)

app/jobs/sample_manifest/generate_wells_job.rb

@@ -5,8 +5,17 @@
     def perform
       ActiveRecord::Base.transaction do
         # Ensure the order of the wells are maintained
+        # Why does the order of the wells matter? Maybe can't use a hash if it does.
+        # Keep key of hash as map_id and query Maps in the generate_wells_job method?
         maps = Map.find(map_ids).index_by(&:id)
-        well_data = map_ids_to_sample_ids.map { |map_id, sample_id| [maps[map_id], sample_id] }
+        well_data = {}
+        map_ids_to_sample_ids.each do |map_id, sample_id|
+          if well_data[maps[map_id]]
+            well_data[maps[map_id]] << sample_id
+          else
+            well_data[maps[map_id]] = [sample_id]
+          end
+        end
 
         sample_manifest.core_behaviour.generate_wells_job(well_data, plate)
       end

app/models/sample_manifest.rb

@@ -6,7 +6,7 @@
 # for the potential samples. It also generates a {SampleManifestExcel}
 # spreadsheet which gets sent to the customer.
 #
-# The labware that gets generate is determined by the {#asset_type} which
+# The labware that gets generated is determined by the {#asset_type} which
 # switches out the {#core_behaviour} module {SampleManifest::CoreBehaviour}.
 # This is concerned with generating {Labware} and {Receptacle receptacles},
 # generating any event specific to the asset type, and setting manifest specific
@@ -49,6 +49,7 @@ def self.included(base)
   has_uploaded_document :generated, differentiator: 'generated'
 
   attr_accessor :override, :only_first_label
+  attr_writer :rows_per_well
 
   class_attribute :spreadsheet_offset
   class_attribute :spreadsheet_header_row
@@ -128,6 +129,13 @@ def default_filename
     "#{study_id}stdy_manifest_#{id}_#{created_at.to_formatted_s(:dmy)}"
   end
 
+  # Use a default value of 1 for rows_per_well if not set
+  def rows_per_well
+    1
+    # TODO: replace above line with below line when we want to turn the 'rows_per_well' feature on
+    # @rows_per_well || 1
+  end
+
   scope :pending_manifests,
         -> {
           order(id: :desc).includes(:uploaded_document).references(:uploaded_document).where(documents: { id: nil })

app/models/sample_manifest/generator.rb

@@ -96,13 +96,21 @@ def execute_print_job
   end
 
   def attributes
-    params.except(:template, :barcode_printer, :only_first_label).merge(user: user, asset_type: asset_type)
+    params
+      .except(:template, :barcode_printer, :only_first_label)
+      .merge(user: user, asset_type: asset_type, rows_per_well: rows_per_well)
   end
 
   def asset_type
     configuration.manifest_types.find_by(params[:template]).asset_type
   end
 
+  # Retrieves the value of the rows_per_well attribute from the manifest_types.yml config.
+  # If the attribute is not set, it returns nil.
+  def rows_per_well
+    configuration.manifest_types.find_by(params[:template]).rows_per_well
+  end
+
   def only_first_label
     ActiveRecord::Type::Boolean.new.cast(params[:only_first_label])
   end

app/models/sample_manifest/plate_behaviour.rb

@@ -40,7 +40,7 @@ def generate_wells(well_data, plates)
       @details_array =
         plates.flat_map do |plate|
           well_data
-            .slice!(0, plate.size)
+            .slice!(0, plate.size * @manifest.rows_per_well)
             .map { |map, sample_id| { barcode: plate.human_barcode, position: map.description, sample_id: sample_id } }
         end
     end
@@ -88,12 +88,15 @@ def labware
     alias printables labware
 
     # Called by {SampleManifest::GenerateWellsJob} and builds the wells
+    # wells_for_plate: Hash, Map to list of SangerSampleIds
     def generate_wells_job(wells_for_plate, plate)
-      wells_for_plate.map do |map, sanger_sample_id|
+      wells_for_plate.map do |map, sanger_sample_ids|
         plate
           .wells
           .create!(map: map) do |well|
-            SampleManifestAsset.create(sanger_sample_id: sanger_sample_id, asset: well, sample_manifest: @manifest)
+            sanger_sample_ids.each do |sanger_sample_id|
+              SampleManifestAsset.create(sanger_sample_id: sanger_sample_id, asset: well, sample_manifest: @manifest)
+            end
           end
       end
       RequestFactory.create_assets_requests(plate.wells, study)
@@ -107,7 +110,7 @@ def generate_wells_job(wells_for_plate, plate)
     # truncate the data.
     def generate_wells_for_plates(well_data, plates)
       cloned_well_data = well_data.dup
-      plates.each { |plate| yield(cloned_well_data.slice!(0, plate.size), plate) }
+      plates.each { |plate| yield(cloned_well_data.slice!(0, plate.size * @manifest.rows_per_well), plate) }
     end
 
     def labware_from_barcodes
@@ -126,13 +129,15 @@ def generate_plates(purpose) # rubocop:todo Metrics/AbcSize
       plates = Array.new(count) { purpose.create!(:without_wells) }.sort_by(&:human_barcode)
 
       plates.each do |plate|
-        sanger_sample_ids = generate_sanger_ids(plate.size)
+        sanger_sample_ids = generate_sanger_ids(plate.size * @manifest.rows_per_well)
 
         plate.maps.in_column_major_order.each do |well_map|
-          sanger_sample_id = sanger_sample_ids.shift
-          generated_sanger_sample_id = SangerSampleId.generate_sanger_sample_id!(study_abbreviation, sanger_sample_id)
+          @manifest.rows_per_well.times do
+            sanger_sample_id = sanger_sample_ids.shift
+            generated_sanger_sample_id = SangerSampleId.generate_sanger_sample_id!(study_abbreviation, sanger_sample_id)
 
-          well_data << [well_map, generated_sanger_sample_id]
+            well_data << [well_map, generated_sanger_sample_id]
+          end
         end
       end
 

app/sample_manifest_excel/sample_manifest_excel/manifest_type_list.rb

@@ -16,6 +16,7 @@ def each(&block)
       manifest_types.each(&block)
     end
 
+    # Hash version of the manifest_types.yml config file
     def manifest_types
       @manifest_types ||= {}
     end
@@ -49,7 +50,7 @@ def <=>(other)
     class ManifestType
       include SequencescapeExcel::Helpers::Attributes
 
-      setup_attributes :name, :columns, :heading, :asset_type
+      setup_attributes :name, :columns, :heading, :asset_type, :rows_per_well
 
       def initialize(attributes = {})
         super
@@ -62,7 +63,8 @@ def to_a
       def ==(other)
         return false unless other.is_a?(self.class)
 
-        name == other.name && columns == other.columns && heading == other.heading && asset_type == other.asset_type
+        name == other.name && columns == other.columns && heading == other.heading && asset_type == other.asset_type &&
+          rows_per_well == other.rows_per_well
       end
     end
 

config/default_records/plate_purposes/011_scrna_core_cdna_prep_plate_purposes.wip.yml

@@ -1,7 +1,15 @@
+# scRNA Core pipeline purposes
+# Most are defined in the Limber config, but the below also need to be defined in Sequencescape.
+# They are in a separate file so it can be 'feature flagged off' until needed.
+---
 # The 'LRC PBMC Pools' purpose is controlled by Limber. However, it has been
 # added here to create submission and request type records for scRNA Core cDNA
 # Prep stage.
----
 LRC PBMC Pools:
   stock_plate: false
   cherrypickable_target: false
+# The 'LRC PBMC Pools Input' purpose is included here so that it's available for
+# sample manifests.
+LRC PBMC Pools Input:
+  stock_plate: true
+  cherrypickable_target: false

config/sample_manifest_excel/manifest_types.yml

@@ -255,6 +255,16 @@ plate_bioscan:
     - :sample_type
     - :donor_id
     - :bioscan_control_type
+plate_scrna_core_pools:
+  heading: "scRNA Core Pools Plate"
+  asset_type: "plate"
+  rows_per_well: 20
+  columns:
+    - :sanger_plate_id
+    - :well
+    - :sanger_sample_id
+    - :supplier_name
+    - :donor_id_mandatory
 tube_default:
   heading: "Default Tube"
   asset_type: "1dtube"

db/migrate/20240214144515_add_rows_per_well_to_sample_manifests.rb

@@ -0,0 +1,6 @@
+# frozen_string_literal: true
+class AddRowsPerWellToSampleManifests < ActiveRecord::Migration[6.0]
+  def change
+    add_column :sample_manifests, :rows_per_well, :integer
+  end
+end

db/schema.rb

@@ -10,7 +10,7 @@
 #
 # It's strongly recommended that you check this file into your version control system.
 
-ActiveRecord::Schema.define(version: 2023_12_04_163029) do
+ActiveRecord::Schema.define(version: 2024_02_14_144515) do
 
   create_table "aliquot_indices", id: :integer, options: "ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci ROW_FORMAT=DYNAMIC", force: :cascade do |t|
     t.integer "aliquot_id", null: false
@@ -1327,6 +1327,7 @@
     t.string "password"
     t.integer "purpose_id"
     t.integer "tube_rack_purpose_id"
+    t.integer "rows_per_well"
     t.index ["purpose_id"], name: "fk_rails_5627ab4aaa"
     t.index ["study_id"], name: "index_sample_manifests_on_study_id"
     t.index ["supplier_id"], name: "index_sample_manifests_on_supplier_id"

spec/data/sample_manifest_excel/extract/manifest_types.yml

@@ -31,6 +31,7 @@ test_2:
 test_3:
   heading: "Yet Another test"
   asset_type: "plate"
+  rows_per_well: 2
   columns:
     - :sanger_plate_id
     - :well

spec/data/sample_manifest_excel/manifest_types.yml

@@ -701,3 +701,12 @@ tube_extraction:
     - :sample_ebi_accession_number
     - :donor_id
     - :phenotype
+pools_plate:
+  heading: "Pools Plate"
+  asset_type: "plate"
+  rows_per_well: 2
+  columns:
+    - :sanger_plate_id
+    - :well
+    - :sanger_sample_id
+    - :supplier_name

spec/features/sample_manifests/create_manifest_spec.rb

@@ -24,7 +24,7 @@ def load_manifest_spec
       select(study.name, from: 'Study')
       select(supplier.name, from: 'Supplier')
       within('#sample_manifest_template') do
-        expect(page).to have_css('option', count: 7)
+        expect(page).to have_css('option', count: 8)
         expect(page).not_to have_css('option', text: 'Default Tube')
       end
       select('Default Plate', from: 'Template')
@@ -66,7 +66,7 @@ def load_manifest_spec
 
     it 'indicate the purpose field is used for plates only' do
       visit(new_sample_manifest_path)
-      within('#sample_manifest_template') { expect(page).to have_css('option', count: 22) }
+      within('#sample_manifest_template') { expect(page).to have_css('option', count: 23) }
       select(created_purpose.name, from: 'Purpose')
       expect(page).to have_text('Used for plate manifests only')
     end

spec/models/sample_manifest/generator_spec.rb

@@ -24,9 +24,10 @@
   let!(:supplier) { create(:supplier) }
   let!(:barcode_printer) { create(:barcode_printer) }
   let(:configuration) { SampleManifestExcel.configuration }
+  let(:template) { 'plate_full' }
 
   let(:attributes) do
-    { template: 'plate_full', study_id: study.id, supplier_id: supplier.id, count: '4' }.with_indifferent_access
+    { template: template, study_id: study.id, supplier_id: supplier.id, count: '4' }.with_indifferent_access
   end
 
   after(:all) { SampleManifestExcel.reset! }
@@ -39,7 +40,7 @@
     expect(described_class.new(attributes, nil, configuration)).not_to be_valid
   end
 
-  it 'is not be unless all of the attributes are present' do
+  it 'is not valid unless all of the attributes are present' do
     SampleManifest::Generator::REQUIRED_ATTRIBUTES.each do |attribute|
       expect(described_class.new(attributes.except(attribute), user, configuration)).not_to be_valid
     end
@@ -123,4 +124,24 @@
   it 'does not have a print job if printer name has not been provided' do
     expect(described_class.new(attributes, user, configuration)).not_to be_print_job_required
   end
+
+  context 'with rows_per_well set' do
+    let(:template) { 'pools_plate' }
+
+    # TODO: un-skip when rows_per_well feature is enabled
+    skip 'generates a details array with more than one entry per well' do
+      generator = described_class.new(attributes, user, configuration)
+      generator.execute
+      expect(generator.sample_manifest.details_array.size).to eq(4 * 96 * 2)
+    end
+  end
+
+  context 'with rows_per_well not set' do
+    # TODO: un-skip when rows_per_well feature is enabled
+    skip 'generates a details array with one entry per well' do
+      generator = described_class.new(attributes, user, configuration)
+      generator.execute
+      expect(generator.sample_manifest.details_array.size).to eq(4 * 96)
+    end
+  end
 end

spec/sample_manifest_excel/manifest_type_list_spec.rb

@@ -20,6 +20,8 @@
       expect(manifest_type.heading).to eq(v['heading'])
       expect(manifest_type.columns).to eq(v['columns'])
       expect(manifest_type.asset_type).to eq(v['asset_type'])
+      # if the rows_per_well attribute isn't present, just compares nil == nil
+      expect(manifest_type.rows_per_well).to eq(v['rows_per_well'])
     end
   end