/* * Eoulsan development code * * This code may be freely distributed and modified under the * terms of the GNU Lesser General Public License version 2.1 or * later and CeCILL-C. This should be distributed with the code. * If you do not have a copy, see: * * http://www.gnu.org/licenses/lgpl-2.1.txt * http://www.cecill.info/licences/Licence_CeCILL-C_V1-en.txt * * Copyright for this code is held jointly by the Genomic platform * of the Institut de Biologie de l'École normale supérieure and * the individual authors. These should be listed in @author doc * comments. * * For more information on the Eoulsan project and its aims, * or to join the Eoulsan Google group, visit the home page * at: * * http://outils.genomique.biologie.ens.fr/eoulsan * */ package fr.ens.biologie.genomique.eoulsan.modules.diffana; import static fr.ens.biologie.genomique.eoulsan.core.InputPortsBuilder.DEFAULT_SINGLE_INPUT_PORT_NAME; import static fr.ens.biologie.genomique.eoulsan.data.DataFormats.EXPRESSION_RESULTS_TSV; import static java.util.Collections.unmodifiableSet; import java.util.HashSet; import java.util.Set; import fr.ens.biologie.genomique.eoulsan.EoulsanException; import fr.ens.biologie.genomique.eoulsan.Globals; import fr.ens.biologie.genomique.eoulsan.annotations.LocalOnly; import fr.ens.biologie.genomique.eoulsan.core.InputPorts; import fr.ens.biologie.genomique.eoulsan.core.InputPortsBuilder; import fr.ens.biologie.genomique.eoulsan.core.Modules; import fr.ens.biologie.genomique.eoulsan.core.Parameter; import fr.ens.biologie.genomique.eoulsan.core.StepConfigurationContext; import fr.ens.biologie.genomique.eoulsan.core.TaskContext; import fr.ens.biologie.genomique.eoulsan.core.TaskResult; import fr.ens.biologie.genomique.eoulsan.core.TaskStatus; import fr.ens.biologie.genomique.eoulsan.core.Version; import fr.ens.biologie.genomique.eoulsan.design.Design; import fr.ens.biologie.genomique.eoulsan.modules.AbstractModule; import fr.ens.biologie.genomique.eoulsan.requirements.Requirement; import fr.ens.biologie.genomique.eoulsan.util.r.RExecutor; /** * This class define the module for normalization * @author deshaies * @since 1.2 */ @LocalOnly public class NormalizationModule extends AbstractModule { private static final String MODULE_NAME = "normalization"; static final String DESEQ1_DOCKER_IMAGE = "genomicpariscentre/deseq:1.8.3"; private Set<Requirement> requirements = new HashSet<>(); private RExecutor executor; // // Module methods // @Override public String getName() { return MODULE_NAME; } @Override public Version getVersion() { return Globals.APP_VERSION; } @Override public String getDescription() { return "This class compute normalisation of expression data for " + "differential analysis."; } @Override public InputPorts getInputPorts() { return new InputPortsBuilder() .addPort(DEFAULT_SINGLE_INPUT_PORT_NAME, true, EXPRESSION_RESULTS_TSV) .create(); } @Override public Set<Requirement> getRequirements() { return unmodifiableSet(this.requirements); } @Override public void configure(final StepConfigurationContext context, final Set<Parameter> stepParameters) throws EoulsanException { // Parse R executor parameters final Set<Parameter> parameters = new HashSet<>(stepParameters); this.executor = RModuleCommonConfiguration.parseRExecutorParameter(context, parameters, this.requirements, DESEQ1_DOCKER_IMAGE); if (!parameters.isEmpty()) { Modules.unknownParameter(context, parameters.iterator().next()); } } @Override public TaskResult execute(final TaskContext context, final TaskStatus status) { try { final Design design = context.getWorkflow().getDesign(); // Launch normalization final Normalization norm = new Normalization(this.executor, design); norm.run(context, context.getInputData(EXPRESSION_RESULTS_TSV)); // Write log file return status.createTaskResult(); } catch (EoulsanException e) { return status.createTaskResult(e, "Error while normalizing expression data: " + e.getMessage()); } } }