Author: echatellier Date: 2015-04-30 13:57:47 +0000 (Thu, 30 Apr 2015) New Revision: 242 Url: http://forge.codelutin.com/projects/isis-fish-docs/repository/revisions/242 Log: Add 4.4 changes detail page Added: trunk/src/site/rst/v4/user/changes/changements44.rst Modified: trunk/src/site/rst/index.rst trunk/src/site/site_fr.xml Modified: trunk/src/site/rst/index.rst =================================================================== --- trunk/src/site/rst/index.rst 2015-04-30 13:18:04 UTC (rev 241) +++ trunk/src/site/rst/index.rst 2015-04-30 13:57:47 UTC (rev 242) @@ -53,7 +53,7 @@ serveur - Possibilité de publier une région sur un serveur -Developpement +Développement ------------- Ce projet est un projet initié à la demande de l'Ifremer et financé par Copied: trunk/src/site/rst/v4/user/changes/changements44.rst (from rev 227, trunk/src/site/rst/v4/user/changements40.rst) =================================================================== --- trunk/src/site/rst/v4/user/changes/changements44.rst (rev 0) +++ trunk/src/site/rst/v4/user/changes/changements44.rst 2015-04-30 13:57:47 UTC (rev 242) @@ -0,0 +1,96 @@ +.. - +.. * #%L +.. * IsisFish +.. * +.. * $Id$ +.. * $HeadURL$ +.. * %% +.. * Copyright (C) 2011 - 2015 Ifremer, CodeLutin, Chatellier Eric +.. * %% +.. * This program 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 3 of the +.. * License, or (at your option) any later version. +.. * +.. * This program 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 this program. If not, see +.. * <http://www.gnu.org/licenses/gpl-3.0.html>. +.. * #L% +.. - + +Changements v 4.4 +================= + +Cette page détaille les changements majeurs introduits dans la version 4.4. + +.. contents:: + +Recrutement +----------- + +Avant, la version 4.4, il n'était pas possible de contrôler la façon dont le +recrutement se faisait. + +La version 4.4 ajoute une nouvelle équation de recrutement, dans l'onglet recrutement d'une population +permettant de redéfinir la façon dont le recrutement peut s'effectuer. + + +La signature complète de cette équation est la suivante: + +.. class:: java + +:: + + public double compute(SimulationContext context, TimeStep step, + Population pop, ReproductionDataMap reproductions, MatrixND result) throws Exception { + + } + +L’exécution de cette équation permet de modifier la matrice ``result`` avec les autres paramètres de l’équation. Elle est appelée **à chaque pas de temps**. + +**Attention: la matrice** ``result`` **n'est pas vide.** Par défaut, elle contient déjà les données de recrutement tel qu'ISIS-Fish le cal par défautcule (voir `PopulationMonitor#getRecruitment <http://www.isis-fish.org/xref/fr/ifremer/isisfish/simulator/PopulationMonitor.html#L241>`_ pour plus d'infos). Cela signifie qu'elle contient donc des données cohérentes même si l’équation de recrutement est vide. + +Détail des paramètres +##################### + +context: `SimulationContext <http://isis-fish.org/apidocs/index.html?fr/ifremer/isisfish/simulator/SimulationContext.html>`_ + Context de simulation +pop: `Population <http://isis-fish.org/apidocs/index.html?fr/ifremer/isisfish/entities/Population.html>`_ + population +reproductions: `ReproductionDataMap <http://isis-fish.org/apidocs/index.html?fr/ifremer/isisfish/types/ReproductionDataMap.html>`_ + Cette structure est specifique à l'equation de recrutement. C'est une map qui contient les données certaines données telles qu'elles étaient *au moment de la période de reproduction*, et en particulier la reproduction. Donc pour chaque pas de temps de la période de reproduction, cette map contient un `ReproductionData <http://isis-fish.org/apidocs/index.html?fr/ifremer/isisfish/types/ReproductionData.html>`_ +result: `MatrixND <http://nuiton-matrix.nuiton.org/v/latest/nuiton-matrix/apidocs/index.html?org/nuiton/math/matrix/MatrixND.html>`_ + La matrice de résultat à modifier + +Exemple pour : reproductions: `ReproductionDataMap <http://isis-fish.org/apidocs/index.html?fr/ifremer/isisfish/types/ReproductionDataMap.html>`_): +Si la période de reproduction s'étale de Janvier à Mars et le delta entre la période de reproduction et de recrutement de 8 moins, la ``Map`` ``reproductions`` contient respectivement: + +- en septembre: + + * janvier : ReproductionData (avec reproduction en janvier) +- en novembre: + + * janvier : ReproductionData (avec reproduction en janvier) + * février : ReproductionData (avec reproduction en février) +- en décembre: + + * janvier : ReproductionData (avec reproduction en janvier) + * février : ReproductionData (avec reproduction en février) + * mars : ReproductionData (avec reproduction en mars) + +Dans le simulateur +################## + +L’équation de recrutement est appelée depuis le simulateur (`DefaultSimulator <http://forge.codelutin.com/projects/isis-fish-data/repository/entry/trunk/simulators/DefaultSimulator.java#L404>`_). Vous pouvez donc vérifier le moment auquel elle est appelée pendant l’exécution de la simulation. En particulier, elle est appelée **après** les migrations de populations. + + +Et beaucoup d'autre bugs... +--------------------------- + +De nombreux autre bugs ont été corrigés. Plus de détail sur cette page : +http://forge.codelutin.com/projects/versions/645. Modified: trunk/src/site/site_fr.xml =================================================================== --- trunk/src/site/site_fr.xml 2015-04-30 13:18:04 UTC (rev 241) +++ trunk/src/site/site_fr.xml 2015-04-30 13:57:47 UTC (rev 242) @@ -74,6 +74,7 @@ <menu name="ISIS-Fish Documentation"> <item name="Documentation" href="v4/index.html" /> <item name="Installation" href="v4/user/installation.html"/> + <item name="Changements 4.4" href="v4/user/changes/changements44.html"/> <item name="Manuel utilisateur" href="v4/user/usermanual.html" collapse="true"> <item name="Introduction" href="v4/user/usermanual/introduction.html"/> <item name="Interface utilisateur" href="v4/user/usermanual/GUI.html">