/*
 * Copyright 2006-2020 The MZmine Development Team
 *
 * This file is part of MZmine.
 *
 * MZmine is free software; you can redistribute it and/or modify it under the terms of the GNU
 * General Public License as published by the Free Software Foundation; either version 2 of the
 * License, or (at your option) any later version.
 *
 * MZmine is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even
 * the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General
 * Public License for more details.
 *
 * You should have received a copy of the GNU General Public License along with MZmine; if not,
 * write to the Free Software Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301
 * USA
 */

package io.github.mzmine.datamodel;

import javax.annotation.Nonnull;
import javax.annotation.Nullable;
import com.google.common.collect.Range;

/**
 * This class represent one spectrum of a raw data file.
 */
public interface Scan extends MassSpectrum {

  /**
   *
   * @return RawDataFile containing this Scan
   */
  @Nonnull
  public RawDataFile getDataFile();

  /**
   *
   * @return Scan number
   */
  public int getScanNumber();

  /**
   *
   * @return Instrument-specific scan definition as String
   */
  public String getScanDefinition();

  /**
   *
   * @return MS level
   */
  public int getMSLevel();

  /**
   *
   * @return Retention time of this scan in minutes
   */
  public float getRetentionTime();

  /**
   *
   * @return The actual scanning range of the instrument
   */
  public @Nonnull Range<Double> getScanningMZRange();

  /**
   *
   * @return Precursor m/z or 0 if this is not MSn scan
   */
  public double getPrecursorMZ();

  public @Nonnull PolarityType getPolarity();

  /**
   *
   * @return Precursor charge or 0 if this is not MSn scan or charge is unknown
   */
  public int getPrecursorCharge();

  @Nonnull
  public MassList[] getMassLists();

  @Nullable
  public MassList getMassList(@Nonnull String name);

  public void addMassList(@Nonnull MassList massList);

  public void removeMassList(@Nonnull MassList massList);

}


@@ -1029,16 +1029,34 @@
 Spectrum
+, Comparable%3CScan%3E
  %7B%0A%0A  /*
@@ -2167,11 +2167,337 @@
 List);%0A%0A
+%0A  /**%0A   * Standard method to sort scans%0A   * @param s%0A   * @return%0A   */%0A  @Override%0A  default int compareTo(@Nonnull Scan s) %7B%0A    int result = Integer.compare(this.getScanNumber(), s.getScanNumber());%0A    if(result!=0)%0A      return result;%0A    else return Float.compare(this.getRetentionTime(), s.getRetentionTime());%0A  %7D%0A
 %7D%0A%0A

Make scan sortable