- Isis-fish-docs-commits - mailman.cloud.codelutin.com

r343 - trunk/src/site
by jcouteau＠users.forge.codelutin.com April 25, 2018

April 25, 2018

Author: jcouteau Date: 2018-04-25 16:05:27 +0200 (Wed, 25 Apr 2018) New Revision: 343 Url: http://forge.codelutin.com/projects/isis-fish-docs/repository/revisions/343 Log: add analysisPlan in menu Modified: trunk/src/site/site_fr.xml Modified: trunk/src/site/site_fr.xml =================================================================== --- trunk/src/site/site_fr.xml 2018-04-18 12:58:28 UTC (rev 342) +++ trunk/src/site/site_fr.xml 2018-04-25 14:05:27 UTC (rev 343) @@ -98,6 +98,7 @@ <item name="Interface utilisateur" href="v4/user/usermanual/GUI.html"> <item name="Saisie de pecherie" href="v4/user/usermanual/inputs.html"/> <item name="Lanceur de simulation" href="v4/user/usermanual/launcher.html"/> + <item name="Plan d'analyse" href="v4/user/usermanual/analysisPlan.html"/> <item name="Lanceur d'analyses de sensibilité" href="v4/user/usermanual/sensitivity.html"/> <item name="Rendu des résultas" href="v4/user/usermanual/results.html"/> <item name="Editeur de script" href="v4/user/usermanual/scripts.html"/>

1 0

r342 - trunk/src/site/rst/v4/user
by jcouteau＠users.forge.codelutin.com April 18, 2018

April 18, 2018

Author: jcouteau Date: 2018-04-18 14:58:28 +0200 (Wed, 18 Apr 2018) New Revision: 342 Url: http://forge.codelutin.com/projects/isis-fish-docs/repository/revisions/342 Log: Update install doc Modified: trunk/src/site/rst/v4/user/installation.rst Modified: trunk/src/site/rst/v4/user/installation.rst =================================================================== --- trunk/src/site/rst/v4/user/installation.rst 2018-03-19 13:32:37 UTC (rev 341) +++ trunk/src/site/rst/v4/user/installation.rst 2018-04-18 12:58:28 UTC (rev 342) @@ -72,7 +72,7 @@ utilisation. Si votre région contient de très nombreux métiers, stratégies et populations vous pouvez devoir augmenter cette valeur pour cela éditez le fichier *isisfish.bat* ou *isisfish.sh* suivant votre -plateforme (Windows, Unix/Linux). +plateforme (Windows, Unix/Linux). La paramètre à changer est -Xmx2G. Par défaut les fichiers de lancement redirigent les sorties vers un fichier ``debug.txt``. Ce fichier est créé à côté du fichier du lancement @@ -166,7 +166,19 @@ database.directory=D\:\\SimulationsISIS\\isis-database-4 default.export.directory=D\:\\SimulationsISIS\\isis-export +Attention, les fichier .isis-config-4 n'existe que si +des modifications ont été apportées à la configuration, si besoin vous pouvez le créer +Modifier la configuration +------------------------- + +Pour modifier la configuration, vous pouvez vous rendre sur l'écran dédié via le menu **Configuration->Configuration**. + +Les options de configuration sont triées par thème. Vous pouvez choisir un thème en sélectionnant l'onglet concerné. +Vous avez ensuite accès aux options de configurations. Vous pouvez visualiser la valeur par défaut et la valeur pour +vous. Vous pouvez ensuite éditer chaque entrée souhaitée en double-cliquant dessus. N'oubliez-pas d'enregistrer vos +modifications avant de quitter + Installer Isis-FISH pour effectuer les simulations sur le super-calculateur DATARMOR ------------------------------------------------------------------------------------

1 0

r341 - trunk/src/site/rst/v4/user
by jcouteau＠users.forge.codelutin.com March 19, 2018

March 19, 2018

Author: jcouteau Date: 2018-03-19 14:32:37 +0100 (Mon, 19 Mar 2018) New Revision: 341 Url: http://forge.codelutin.com/projects/isis-fish-docs/repository/revisions/341 Log: Update install doc Modified: trunk/src/site/rst/v4/user/installation.rst Modified: trunk/src/site/rst/v4/user/installation.rst =================================================================== --- trunk/src/site/rst/v4/user/installation.rst 2018-03-13 11:01:15 UTC (rev 340) +++ trunk/src/site/rst/v4/user/installation.rst 2018-03-19 13:32:37 UTC (rev 341) @@ -30,7 +30,7 @@ --------------- Afin de pouvoir faire tourner ISIS-Fish sur votre machine, il est -nécessaire d'avoir au moins la version *1.8* de Java d'installée. Il est +nécessaire d'avoir la version *1.8* de Java d'installée. Il est possible de connaître la version actuellement installée sur votre ordinateur en tapant dans une commande DOS : «java -version». Si vous aboutissez à un message d'erreur, cela signifie que Java n'est pas @@ -39,6 +39,8 @@ version de Java SE Development Kit (JDK). Ceci peut se faire directement à cette adresse : http://www.oracle.com/technetwork/java/javase/downloads/index.html +*Attention, ISIS-Fish ne fonctionne pas en Java 9.* + Comment se procurer ISIS-Fish ----------------------------- @@ -66,7 +68,7 @@ Fichier de lancement par défaut .bat et .sh ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -Par défaut ISIS-Fish peut allouer au maximum 1Go de Ram pour son +Par défaut ISIS-Fish peut allouer au maximum 2Go de Ram pour son utilisation. Si votre région contient de très nombreux métiers, stratégies et populations vous pouvez devoir augmenter cette valeur pour cela éditez le fichier *isisfish.bat* ou *isisfish.sh* suivant votre @@ -73,16 +75,18 @@ plateforme (Windows, Unix/Linux). Par défaut les fichiers de lancement redirigent les sorties vers un -fichier ``debug.txt``. Si jamais un problème se produit durant +fichier ``debug.txt``. Ce fichier est créé à côté du fichier du lancement +après avoir lancé ISIS-Fish. Si jamais un problème se produit durant l'utilisation d'ISIS-Fish ce fichier peut vous permettre de comprendre plus simplement le problème. Si vous faites appel aux mailing-lists pour demander de l'aide, il vous sera demandé de joindre ce fichier à votre demande. -Lancer ISIS-Fish sous windows +Lancer ISIS-Fish sous Windows ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ Double-cliquer sur le fichier .bat créé. Une fenêtre DOS va alors -s'ouvrir. Puis l'interface d'ISIS. +s'ouvrir. Puis l'interface d'ISIS. Au premier lancement, le délai peut être +long (ISIS-Fish récupère des données depuis Internet). .. image:: usermanual/mainWindow.png @@ -102,81 +106,20 @@ ./isisfish.sh -Option de la ligne de commande ------------------------------- +Le fonctionnement est ensuite similaire à Windows -Il est possible de passer des paramètres à la ligne de commande par exemple:: - - ./isisfish.sh --help - -l'option ``--help`` permet d'afficher la liste des options disponibles - -Voici les autres options. - -================================================ ======================================================================================================================================================================================================= -Commande Description -================================================ ======================================================================================================================================================================================================= --help, -h Affiche l'aide --listRegion Affiche la liste des régions disponibles --importRegion region Importe une région dans la base locale. Il est possible d'importer des régions depuis ISIS-Fish version 2 ou 3. Suivant l'extension du fichier, ISIS-Fish fera la bonne opération --importAndRenameRegion region newName Importe une région dans la base local et modifie son nom durant l'import. --exportRegion regionName output.zip Exporte une région existante dans la base locale sous la forme d'un fichier zip importable ultérieurement. --listSimulation Affiche la liste des simulations disponibles --importSimulation simulation Importe une simulation dans la base locale --exportSimulation simulationName simulation.zip Exporte une simulation existante dans la base locale sous la forme d'un fichier zip importable ultérieurement. --update <true|false> Force la mise à jour des scripts comme lors du premier lancement d'ISIS-Fish --create-ssh-key Permet de créer une paire de clé ssh. Ces clés sont utilisées pour pouvoir modifier les scripts pour les personnes ayant un login sur le CVS hébergeant les sources des scripts. (Voir le chapitre CVS) --ssh-key-file pathToPrivateKey Permet d'indiquer à ISIS-Fish d'utiliser une paire de clés ssh existantes pour l'accès au CVS. (Voir le chapitre CVS) --config name value Permet de modifier des valeurs de configuration. Cela revient au même que de modifier le fichier $HOME/.isis-config-3, ou utiliser l'interface depuis le menu fenêtre->configuration. -================================================ ======================================================================================================================================================================================================= - -Liste des options disponibles: - -======================= ================================================================================================================================================== ====================================================================================================== =================================================== -option description type exemple -======================= ================================================================================================================================================== ====================================================================================================== =================================================== -compileDirectory répertoire utilisé pour la compilation des scripts chemin vers un répertoire /tmp/isis-build -language La langue à utiliser ISO Language Code http://www.loc.gov/standards/iso639-2/englangn.html fr -country La variable pays pour la langue ISO Country Code http://www.iso.ch/iso/en/prods-services/iso3166ma/02iso-3166-code-lists/lis… FR -database répertoire utilisé pour stocker les informations chemin vers un répertoire /home/poussin/isis-database-3 -defaultSimulator nom du fichier à utiliser comme simulateur nom d'un fichier .java contenu dans le répertoire $database/simulators DefaultSimulator.java -javadocUrl URL pointant vers la javadoc du simulateur URL http://isis-fish.labs.libre-entreprise.org/apidocs/ -defaultExportDirectory Répertoire ou les exports de simulation sont placé par défaut chemin vers un répertoire /home/poussin/isis-export -defaultExportNames la liste des noms des exports par défaut à utiliser liste séparée par des virgules Abundances.java,Biomasses.java -defaultResultNames la liste des résultats que l'on souhaite conserver durant la simulation pour les visualiser ultérieurement via l'interface de rendu des résultats. liste séparé par des virgules matrixDiscardsWeightPerStrMet,matrixPrice -defaultMap la carte à utiliser par défaut pour nouvelle région le chemin d'un fichier de carte .shp sans l'extension maps/vmap_area_thin -defaultTagValue la liste des tags values à utiliser par défaut pour les simulations liste séparé par des virgules de couple "nom":"valeur" "ecoResult":"true","maVal":"truc" -cvsHostName le nom du serveur contenant l'arbre CVS des données le nom d'un serveur ou une ip labs.libre-entreprise.org -cvsRepository le répertoire racine du CVS sur le serveur chemin vers un répertoire /cvsroot/isis-fish -cvsDataBase le nom du module CVS contenant les données sur le serveur String isis-fish-data -cvsHost fichier contenant les cles des serveurs CVS chemin d'un fichier xml /home/poussin/.isis-ssh-host.xml -cvsUserName le nom de l'utilisateur pouvant accéder au CVS login anonymous ou bpoussin -cvsSsh2Connexion indique si l'on utilise ou non un accès sécurisé au CVS. Cela n'est pas utile pour le compte anonymous et nécessite une clé SSH boolean true -cvsKeyFile le fichier contenant la clé privée SSH chemin vers un fichier /home/poussin/.ssh/id_dsa -smtpServer le nom du serveur SMTP à utiliser pour envoyer des mails. nom d'un serveur ou ip smtp.codelutin.com -localSimulator valeur par défaut utilisée pour savoir si les simulations que l'on exécute doivent être faites localement ou sur un serveur de simulation boolean true -simulatorServer URL permettant de contacter le serveur de simulations URL http://simulateur.ifremer.fr:9090 -simulatorServerLogin le login à utiliser pour le serveur de simulations login bpoussin -simulatorServerPassword le mot de passe à utiliser pour le serveur de simulations mot de passe guest -======================= ================================================================================================================================================== ====================================================================================================== =================================================== - Premier lancement et fichier de configuration --------------------------------------------- -Lors du premier lancement ISIS-Fish vous posera un certain nombre de -question. +Lors du premier lancement ISIS-Fish, la configuration par défaut est appliquée. Vous pouvez modifier la configuration +ultérieurement via les interfaces graphiques ou en éditant ``$HOME/.config/isis-config-4`` (le fichier n'existe que si +des modifications ont été apportées à la configuration, si besoin vous pouvez le créer) . -Si vous souhaitez les modifier ultérieurement il faut éditer le -fichier ``$HOME/.config/isis-config-4``. - ``$HOME`` est une variable d'environnement sous Unix/Linux qui pointe vers le répertoire utilisateur de la personne logguée. Sous Windows l'utilisateur à aussi un espace de travail personnel, mais son emplacement varie suivant la version de Windows utilisée. -Données et scripts initiaux ---------------------------- - Lors du premier lancement, il est conseillé d'être connecté à Internet, car ISIS-Fish récupère une région de démonstration et les scripts de simulation, export... @@ -212,7 +155,7 @@ Par défault, la zone de travail est ``C:\Documents and Settings\chezsoi`` (zone où sont créés les répertoires ``isis-database``, ``isis-build``,...). Pour changer de zone de travail, il suffit de changer le répertoire par défaut dans le -``isis-config`` par le répertoire choisi. +``isis-config-4`` par le répertoire choisi. Fichier exemple :: @@ -224,14 +167,14 @@ default.export.directory=D\:\\SimulationsISIS\\isis-export -Installer Isis-FISH pour effectuer les simulations sur le super-calculateur CAPARMOR +Installer Isis-FISH pour effectuer les simulations sur le super-calculateur DATARMOR ------------------------------------------------------------------------------------ -Afin d'utiliser Caparmor pour effectuer les simulations, il convient de suivre -une procédure particulière (et d'avoir l'autorisation d'utiliser Caparmor). La +Afin d'utiliser Datarmor pour effectuer les simulations, il convient de suivre +une procédure particulière (et d'avoir l'autorisation d'utiliser Datarmor). La procédure décrite dans le fichier joint devrait vous permettre de configurer et -utiliser ISIS et Caparmor correctement. +utiliser ISIS et Datarmor correctement. -`Installation d'ISIS-Caparmor`_ +`Installation d'ISIS-Datarmor`_ -.. _Installation d'ISIS-Caparmor: installation-isis-caparmor.pdf +.. _Installation d'ISIS-Datarmor: installation-isis-caparmor.pdf

1 0

r340 - trunk/src/site/rst/v4/user/tutorials
by jcouteau＠users.forge.codelutin.com March 13, 2018

March 13, 2018

Author: jcouteau Date: 2018-03-13 12:01:15 +0100 (Tue, 13 Mar 2018) New Revision: 340 Url: http://forge.codelutin.com/projects/isis-fish-docs/repository/revisions/340 Log: Fix rst syntax Modified: trunk/src/site/rst/v4/user/tutorials/optimization.rst Modified: trunk/src/site/rst/v4/user/tutorials/optimization.rst =================================================================== --- trunk/src/site/rst/v4/user/tutorials/optimization.rst 2018-03-12 15:41:19 UTC (rev 339) +++ trunk/src/site/rst/v4/user/tutorials/optimization.rst 2018-03-13 11:01:15 UTC (rev 340) @@ -42,18 +42,13 @@ simulations précédentes. Voici l'ensemble des méthodes présentes dans le script: - * ``getNecessaryResult()`` : retourne l'ensemble des résultats devant être calculés par l'ensemble des simulations et - nécessaires à l'exécution du script d'optimisation - * ``getDescription()`` : retourne une description du script à destination de l’utilisateur (affichée dans l'interface - de lancement) - * ``init(OptimizationContext)`` : sert à initialiser le script d’optimisation (appelée une fois, avant le lancement du - script) - * ``firstSimulation(OptimizationContext)`` : sert à générer la première génération de simulation (appelée une fois au - lancement du script) + * ``getNecessaryResult()`` : retourne l'ensemble des résultats devant être calculés par l'ensemble des simulations et nécessaires à l'exécution du script d'optimisation + * ``getDescription()`` : retourne une description du script à destination de l’utilisateur (affichée dans l'interface de lancement) + * ``init(OptimizationContext)`` : sert à initialiser le script d’optimisation (appelée une fois, avant le lancement du script) + * ``firstSimulation(OptimizationContext)`` : sert à générer la première génération de simulation (appelée une fois au lancement du script) * ``nextSimulation(OptimizationContext)`` : est appelée à chaque nouvelle génération de simulation * ``endSimulation(OptimizationContext)`` : est appelée à chaque fin d’exécution d'une génération de simulations - * ``finish(OptimizationContext context)`` : appelée une fois, à la fin du script, lorsque que l'ensemble des - générations de simulations sont terminées + * ``finish(OptimizationContext context)`` : appelée une fois, à la fin du script, lorsque que l'ensemble des générations de simulations sont terminées Génération de simulations @@ -74,14 +69,9 @@ * de produire de nouvelles simulations dans la génération courante Liste des méthodes disponibles: - * ``context.getCurrentGeneration()`` : permet de connaitre le numéro de la génération en cours. Par exemple, au 3ème - appel de ``nextSimulation()`` le compteur sera égal à ``3`` (en prenant en compte que le compteur est égal à ``0`` - dans la méthode ``firstSimulation()``) - * ``context.newSimulation()`` : crée une nouvelle simulation dans la génération courante et la retourne sous forme de - ``SimulationStorage`` (pour être modifiée par l'utilisateur avant son lancement) - * ``context.getLastSimulations()`` : retourne l'ensemble des simulations exécutée dans la dernière génération. Les - ``SimulationStorage`` retournés peuvent - être lus pour en extraire des résultats + * ``context.getCurrentGeneration()`` : permet de connaitre le numéro de la génération en cours. Par exemple, au 3ème appel de ``nextSimulation()`` le compteur sera égal à ``3`` (en prenant en compte que le compteur est égal à ``0`` dans la méthode ``firstSimulation()``) + * ``context.newSimulation()`` : crée une nouvelle simulation dans la génération courante et la retourne sous forme de ``SimulationStorage`` (pour être modifiée par l'utilisateur avant son lancement) + * ``context.getLastSimulations()`` : retourne l'ensemble des simulations exécutée dans la dernière génération. Les ``SimulationStorage`` retournés peuvent être lus pour en extraire des résultats Condition d'arrêt

1 0

r339 - trunk/src/site/rst/v4/user/tutorials
by jcouteau＠users.forge.codelutin.com March 12, 2018

March 12, 2018

Author: jcouteau Date: 2018-03-12 16:41:19 +0100 (Mon, 12 Mar 2018) New Revision: 339 Url: http://forge.codelutin.com/projects/isis-fish-docs/repository/revisions/339 Log: Update optimisation doc Modified: trunk/src/site/rst/v4/user/tutorials/optimization.rst Modified: trunk/src/site/rst/v4/user/tutorials/optimization.rst =================================================================== --- trunk/src/site/rst/v4/user/tutorials/optimization.rst 2018-01-30 13:55:12 UTC (rev 338) +++ trunk/src/site/rst/v4/user/tutorials/optimization.rst 2018-03-12 15:41:19 UTC (rev 339) @@ -27,35 +27,43 @@ Optimisation ============ -Les scripts d'optimisation servent à lancer plusieurs séries de simulation et évaluant à chaque itération si le script doit continuer. -Cette condition est vérifiée par une fonction d'objectif qui analyse les exports habituels des simulations par rapport aux observations renseignées -dans la base de données. +Les scripts d'optimisation servent à lancer itérativement des séries de simulation en évaluant à chaque itération si le +script doit continuer. Cette évaluation se base sur le calcul d'une fonction d'objectif qui compare les résultats des +simulations exportés aux observations renseignées dans la base de données. Script d'optimisation ===================== -Un script d'optimisation est relativement similaire à un plan d'analyse, mais il comprend quelques méthodes en plus. Son but est de générer un -ensemble de simulation à être executée et déterminer une condition à l'arrêt du script. +Un script d'optimisation est relativement similaire à un plan d'analyse, mais il comprend quelques méthodes en plus. Son +but est 1) de générer séquentiellement un ensemble de simulations qui seront executées et 2) déterminer une condition à +l'arrêt du script. La particularité est la possible combinaison de simulations séquentielles et parallèles et le fait +que les paramètres d’une nouvelle série de simulations sont déterminés au cours du plan sur la base des résultats des +simulations précédentes. Voici l'ensemble des méthodes présentes dans le script: - * ``getNecessaryResult()`` : retourne l'ensemble des résultats devant être calculés par l'ensemble des simulations et nécessaire à l'execution du - script d'optimisation - * ``getDescription()`` : retourne une description du script à destination de l’utilisateur (affichée dans l'interface de lancement) - * ``init(OptimizationContext)`` : sert à initialiser le script d’optimisation (appelée une fois, avant le lancement du script) - * ``firstSimulation(OptimizationContext)`` : sert à générer la première génération de simulation (appelée une fois au lancement du script) - * ``nextSimulation(OptimizationContext)`` : est appelée plusieurs fois, a chaque génération de simulation - * ``endSimulation(OptimizationContext)`` : est appelée plusieurs fois, à chaque fin d’exécution d'une génération de simulation - * ``finish(OptimizationContext context)`` : appelée une fois, à la fin du script, lorsque que l'ensemble des générations de simulation ont terminé + * ``getNecessaryResult()`` : retourne l'ensemble des résultats devant être calculés par l'ensemble des simulations et + nécessaires à l'exécution du script d'optimisation + * ``getDescription()`` : retourne une description du script à destination de l’utilisateur (affichée dans l'interface + de lancement) + * ``init(OptimizationContext)`` : sert à initialiser le script d’optimisation (appelée une fois, avant le lancement du + script) + * ``firstSimulation(OptimizationContext)`` : sert à générer la première génération de simulation (appelée une fois au + lancement du script) + * ``nextSimulation(OptimizationContext)`` : est appelée à chaque nouvelle génération de simulation + * ``endSimulation(OptimizationContext)`` : est appelée à chaque fin d’exécution d'une génération de simulations + * ``finish(OptimizationContext context)`` : appelée une fois, à la fin du script, lorsque que l'ensemble des + générations de simulations sont terminées -Génération de simulation ------------------------- +Génération de simulations +------------------------- -Dans les scripts d'optimisation, on parle de "génération de simulation" pour désigner un ensemble de simulation que le script d'optimisation -génere à chaque itération. +Dans les scripts d'optimisation, on parle de "génération de simulations" pour désigner un ensemble de simulations +indépendantes que le script d'optimisation crée à chaque itération à partir des résultats de la génération précédente. -Chaque génération comprend plusieurs simulation qui sont exécutées en **parallèle**. Mais les "génération de simulation" sont exécutées **séquentiellement**. +Chaque génération comprend plusieurs simulations qui sont exécutées en **parallèle**. Mais les "générations de +simulations" sont exécutées **séquentiellement**. OptimisationContext @@ -63,28 +71,34 @@ L'objet ``OptimizationContext`` est un objet qui est donné à chaque méthode du script d'optimisation. Il permet de: * connaitre l'état d'avancement du script - * de produire de nouvelles simulation dans la génération courante + * de produire de nouvelles simulations dans la génération courante Liste des méthodes disponibles: - * ``context.getCurrentGeneration()`` : permet de connaitre le numéro de la génération en cours. Par exemple, au 3ème appel de ``nextSimulation()`` le compteur sera égal à ``3`` (en prenant en compte que le compteur est égal à ``0`` dans la méthode ``firstSimulation()`` - * ``context.newSimulation()`` : crée une nouvelle simulation dans la génération courante et la retourne sous forme de ``SimulationStorage`` (pour être modifiée par l'utilisateur avant son lancement) - * ``context.getLastSimulations()`` : retourne l'ensemble des simulations exécutée dans la dernière génération. Les ``SimulationStorage`` retournés peuvent - être lus pour en extraire des résultats + * ``context.getCurrentGeneration()`` : permet de connaitre le numéro de la génération en cours. Par exemple, au 3ème + appel de ``nextSimulation()`` le compteur sera égal à ``3`` (en prenant en compte que le compteur est égal à ``0`` + dans la méthode ``firstSimulation()``) + * ``context.newSimulation()`` : crée une nouvelle simulation dans la génération courante et la retourne sous forme de + ``SimulationStorage`` (pour être modifiée par l'utilisateur avant son lancement) + * ``context.getLastSimulations()`` : retourne l'ensemble des simulations exécutée dans la dernière génération. Les + ``SimulationStorage`` retournés peuvent + être lus pour en extraire des résultats Condition d'arrêt ----------------- -Un script d'optimisation s'arrête lorsqu'il n'y a plus de simulation à executer. +Un script d'optimisation s'arrête lorsqu'il n'y a plus de simulation à exécuter. -Donc, pour arrêter un script, il faut, dans la méthode ``nextSimulation(OptimizationContext)`` ne faire aucun appel à ``context.newSimulation()``. +Donc, pour arrêter un script, il faut, dans la méthode ``nextSimulation(OptimizationContext)`` ne faire aucun appel à +``context.newSimulation()``. Fonction d'objectif =================== -Une fonction d'objectif sert à retourner un indicateur sur l'execution d'une simulation. Cette fonction d'objectif est à paramêtre à définir lors -du lancement d'un script d'optimsation et peut donc être différente à chaque fois. +Une fonction d'objectif sert à retourner une valeur à la fin de l'exécution d'une simulation. Cette fonction d'objectif +n'est pas générique et dépend de l'optimisation réalisée. Par exemple pour une calibration, elle consiste en général à +comparer des sorties de simulation à des observations. Elle doit être programmée par l’utilisateur. Structure @@ -95,7 +109,8 @@ - ``getNecessaryResult()`` pour définir les résultats à calculer pour le fonction d'objectif - ``getDescription()`` pour fournir une description à l'utilisateur -Il contient surtout une seule méthode spécifique : ``double eval(OptimizationContext context, List<MatrixND> exports, List<MatrixND> observations)``. +Il contient surtout une seule méthode spécifique : ``double eval(OptimizationContext context, List<MatrixND> exports, +List<MatrixND> observations)`` qui sert au calcul de la fonction d’objectif. Cette méthode prend en paramètres: * le contexte de simulation @@ -102,18 +117,18 @@ * les résultats des exports calculés par la simulation * les observations définis lors du lancement du script d'optimisation -Le but de la fonction d'objectif est de comparer les exports aux observations et à définir un indicateur ``double`` qui pourra être utile au script -d'optimisation. +Le but de la fonction d'objectif est de comparer les exports aux observations et à définir un indicateur ``double`` qui +pourra être utile au script d'optimisation. -Le résultat de la fonction d'objectif est stocké dans le ``SimulationStorage`` et pourra être récupéré, à la fin de chaque génération, avec la méthode -``SimulationStorage#getObjective()`` +Le résultat de la fonction d'objectif est stocké dans le ``SimulationStorage`` et pourra être récupéré, à la fin de +chaque génération, avec la méthode ``SimulationStorage.getObjective()`` Exemple ======= -Fonction d'objectif ``Objectif3Iteration.java``. Cette fonction d'objectif est très simple. Elle retourne -1 losque que 3 générations de simulation -ont été executées. +Fonction d'objectif ``Objectif3Iteration.java``. Cette fonction d'objectif est très simple. Elle retourne -1 lorsque que +3 générations de simulations ont été exécutées. .. class:: java @@ -130,7 +145,8 @@ } } -Script d'optimisation ``ExampleObjectif.java``. Cet example génère des séries de 2 simulations, tant que la fonction d'objectif n'a pas retourné ``-1``. +Script d'optimisation ``ExampleObjectif.java``. Cet script d'optimisation génère des séries de 2 simulations, tant que +la fonction d'objectif n'a pas retourné ``-1``. .. class:: java @@ -167,4 +183,4 @@ } } -Dans cette exemple, cette fonction d'optimisation aura lancé 8 simulations (4 séries de 2 simulations). +Dans cet exemple, cette fonction d'optimisation aura lancé 8 simulations (4 séries de 2 simulations).

1 0

r338 - in trunk/src/site/rst/v4/user: . tutorials
by echatellier＠users.forge.codelutin.com Jan. 30, 2018

Jan. 30, 2018

Author: echatellier Date: 2018-01-30 14:55:12 +0100 (Tue, 30 Jan 2018) New Revision: 338 Url: http://forge.codelutin.com/projects/isis-fish-docs/repository/revisions/338 Log: Ajout de doc sur les matrices Added: trunk/src/site/rst/v4/user/tutorials/matrix.rst Modified: trunk/src/site/rst/v4/user/tutorials.rst Copied: trunk/src/site/rst/v4/user/tutorials/matrix.rst (from rev 335, trunk/src/site/rst/v4/user/tutorials/useAPI.rst) =================================================================== --- trunk/src/site/rst/v4/user/tutorials/matrix.rst (rev 0) +++ trunk/src/site/rst/v4/user/tutorials/matrix.rst 2018-01-30 13:55:12 UTC (rev 338) @@ -0,0 +1,100 @@ +.. - +.. * #%L +.. * IsisFish +.. * +.. * $Id$ +.. * $HeadURL$ +.. * %% +.. * Copyright (C) 2018 Ifremer, Code Lutin +.. * %% +.. * 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% +.. - + +Utilisation des matrices dans ISIS-Fish +======================================= + +Dans ISIS-Fish, les matrices sont implémentées par un projet externe : `Nuiton-matrix <http://nuiton-matrix.nuiton.org>`_. + + +Import de matrix N dimension avec les sémantiques +------------------------------------------------- + +Fichier CVS +~~~~~~~~~~~ + +Pour importer des matrices N dimension en reférancant les coordonées par leur sémantique, il faut produire un fichier CSV dans le format suivant: + +.. class:: txt + +:: + + [dimensions] valeurParDefaut + semantique1 + semantique2 + ... + coordonnées1;coordonnées1;valeur + coordonnées1;coordonnées1;valeur + +Par exemple: + +.. class:: csv + +:: + + [2,3] 0 + Population:merluccius,nephrops + Zone:zone_merlu_recrutement,zone_merlu_presence,zone_merlu_reproduction + 0;0;42 + 1;2;24 + 1;0;0.5 + +Ce fichier importé défini trois valeur particulière pour (merluccius,zone_merlu_recrutement), (nephrops,zone_merlu_reproduction) et (nephrops,zone_merlu_recrutement). +Toutes les autres cellules de la matrice auront pour valeur la valeur par défaut : ``0``. + +Sémantique +~~~~~~~~~~ + +Les sémantiques utilisées dans ce format doivent correspondre aux objets réel de la matrice importé. + +Les types peuvent être des objets java: + * ``java.lang.String`` + * ``java.lang.Integer`` + * ``java.lang.Double`` + * ... + +ou des objets ISIS-Fish: + * ``Cell`` + * ``Zone`` + * ``Port`` + * ``Species`` + * ``Population`` + * ``PopulationGroup`` + * ``Gear`` + * ``VesselType`` + * ``TripType`` + * ``SetOfVessels`` + * ``Strategie`` + * ``Observation`` + * ``Metier`` + * ... + +Ensuite, chaque objet doit être représenté par son **nom**. Par exemple, pour les populations de nom ``merluccius`` et ``nephrops``, on écrira: +``Population:merluccius,nephrops`` + +Il y a toutefois un cas particulier concernant les groupes de population (``PopulationGroup``). Dans l'application, un groupes de population n'a pas +de nom mais un numéro de groupe. Dans pour référencer un groupe, on utilisera la syntaxe : ``<nomdepopulation>+<numerodegroupe>``. Par exemple:: + + PopulationGroup:nephrops+0,nephrops+1,nephrops+2,nephrops+3,nephrops+4,nephrops+5,nephrops+6,nephrops+7,nephrops+8 Modified: trunk/src/site/rst/v4/user/tutorials.rst =================================================================== --- trunk/src/site/rst/v4/user/tutorials.rst 2018-01-29 15:55:41 UTC (rev 337) +++ trunk/src/site/rst/v4/user/tutorials.rst 2018-01-30 13:55:12 UTC (rev 338) @@ -5,7 +5,7 @@ .. * $Id$ .. * $HeadURL$ .. * %% -.. * Copyright (C) 1999 - 2013 Ifremer, Code Lutin +.. * Copyright (C) 1999 - 2018 Ifremer, Code Lutin .. * %% .. * This program is free software: you can redistribute it and/or modify .. * it under the terms of the GNU General Public License as @@ -27,26 +27,33 @@ =================== * `Première utilisation d'ISIS-Fish`_ -* `Exemple de parametrisation d une pecherie`_ +* `Exemple de paramétrisation d une pecherie`_ * `Les plans d'analyse`_ +* `Les script d'optimisation`_ * `Tutoriaux JAVA`_ -* `Un site très pedagogique pour apprendre à programmer en JAVA`_ +* `Un site très pédagogique pour apprendre à programmer en JAVA`_ * `Comment utiliser les APIs`_ * `Quelques commandes utiles pour les simulations sur CAPARMOR`_ * `Creer un nouveau resultat et export`_ +* `Utilisation des matrices dans ISIS-Fish`_ .. _Première utilisation d'ISIS-Fish: tutorials/firstLaunch.html .. _Tutoriaux JAVA: http://docs.oracle.com/javase/tutorial/ -.. _Un site très pedagogique pour apprendre à programmer en JAVA: http://fr.openclassrooms.com/informatique/cours/apprenez-a-programmer-en-ja… +.. _Un site très pédagogique pour apprendre à programmer en JAVA: http://fr.openclassrooms.com/informatique/cours/apprenez-a-programmer-en-ja… .. _Quelques commandes utiles pour les simulations sur CAPARMOR: tutorials/utilCaparmor.html .. _Les plans d'analyse: tutorials/simulationPlan.html -.. _Exemple de parametrisation d une pecherie: tutorials/parameterising.html +.. _Les script d'optimisation: tutorials/optimization.html +.. _Exemple de paramétrisation d une pecherie: tutorials/parameterising.html + .. _Comment utiliser les APIs: tutorials/useAPI.html .. _Creer un nouveau resultat et export: tutorials/newResult.html + +.. _Utilisation des matrices dans ISIS-Fish: tutorials/matrix.html +

1 0

r337 - trunk/src/site/rst/v4/user/tutorials
by echatellier＠users.forge.codelutin.com Jan. 29, 2018

Jan. 29, 2018

Author: echatellier Date: 2018-01-29 16:55:41 +0100 (Mon, 29 Jan 2018) New Revision: 337 Url: http://forge.codelutin.com/projects/isis-fish-docs/repository/revisions/337 Log: Corrections Modified: trunk/src/site/rst/v4/user/tutorials/optimization.rst Modified: trunk/src/site/rst/v4/user/tutorials/optimization.rst =================================================================== --- trunk/src/site/rst/v4/user/tutorials/optimization.rst 2018-01-29 13:35:47 UTC (rev 336) +++ trunk/src/site/rst/v4/user/tutorials/optimization.rst 2018-01-29 15:55:41 UTC (rev 337) @@ -27,7 +27,7 @@ Optimisation ============ -Les scripts d'optimsation servent à lancer plusieurs série de simulation et évaluant à chaque itération si le script doit continuer. +Les scripts d'optimisation servent à lancer plusieurs séries de simulation et évaluant à chaque itération si le script doit continuer. Cette condition est vérifiée par une fonction d'objectif qui analyse les exports habituels des simulations par rapport aux observations renseignées dans la base de données. @@ -40,7 +40,7 @@ Voici l'ensemble des méthodes présentes dans le script: * ``getNecessaryResult()`` : retourne l'ensemble des résultats devant être calculés par l'ensemble des simulations et nécessaire à l'execution du - script d'optimsation + script d'optimisation * ``getDescription()`` : retourne une description du script à destination de l’utilisateur (affichée dans l'interface de lancement) * ``init(OptimizationContext)`` : sert à initialiser le script d’optimisation (appelée une fois, avant le lancement du script) * ``firstSimulation(OptimizationContext)`` : sert à générer la première génération de simulation (appelée une fois au lancement du script) @@ -55,23 +55,21 @@ Dans les scripts d'optimisation, on parle de "génération de simulation" pour désigner un ensemble de simulation que le script d'optimisation génere à chaque itération. -Chaque génération comprend plusieurs simulation qui sont executées en parallèle. Mais les "génération de simulation" sont exeution séquantiellement. +Chaque génération comprend plusieurs simulation qui sont exécutées en **parallèle**. Mais les "génération de simulation" sont exécutées **séquentiellement**. OptimisationContext ------------------- -L'objet ``OptimizationContext`` est un object qui est donné à chaque méthode du script d'otpimisation. Il permet de: +L'objet ``OptimizationContext`` est un objet qui est donné à chaque méthode du script d'optimisation. Il permet de: * connaitre l'état d'avancement du script * de produire de nouvelles simulation dans la génération courante Liste des méthodes disponibles: - * ``context.getCurrentGeneration()`` : permet de connaitre le numéro de la génération en cours. Par exemple, au 3ème appel de ``nextSimulation()`` le - compteur sera égal à ``3`` (en prenant en compte que le compteur est égale à ``0`` dans la méthode ``firstSimulation()`` - * ``context.newSimulation()`` : crée une nouvelle simulation dans la simulation courante et la retourne sous forme de SimulationStorage (pour être - modifiée par l'utilsateur avant son lancement) - * ``context.getLastSimulations()`` : retourne l'ensemble des simulations exécutée dans la dernière génération. Les ``SimulationStorage`` retournée peuvent - être lu pour en extraire des résultats + * ``context.getCurrentGeneration()`` : permet de connaitre le numéro de la génération en cours. Par exemple, au 3ème appel de ``nextSimulation()`` le compteur sera égal à ``3`` (en prenant en compte que le compteur est égal à ``0`` dans la méthode ``firstSimulation()`` + * ``context.newSimulation()`` : crée une nouvelle simulation dans la génération courante et la retourne sous forme de ``SimulationStorage`` (pour être modifiée par l'utilisateur avant son lancement) + * ``context.getLastSimulations()`` : retourne l'ensemble des simulations exécutée dans la dernière génération. Les ``SimulationStorage`` retournés peuvent + être lus pour en extraire des résultats Condition d'arrêt @@ -93,21 +91,21 @@ --------- Un script d'optimisation à des méthodes classiques aux autres scripts: - - init() pour initialiser la fonction d'objectif - - getNecessaryResult() pour définir les résultats à calculer pour le fonction d'objectif - - getDescription()pour fournir une description à l'utilsateur + - ``init()`` pour initialiser la fonction d'objectif + - ``getNecessaryResult()`` pour définir les résultats à calculer pour le fonction d'objectif + - ``getDescription()`` pour fournir une description à l'utilisateur Il contient surtout une seule méthode spécifique : ``double eval(OptimizationContext context, List<MatrixND> exports, List<MatrixND> observations)``. Cette méthode prend en paramètres: * le contexte de simulation - * les résultats des exports définis au lancement du script d'optimisation + * les résultats des exports calculés par la simulation * les observations définis lors du lancement du script d'optimisation Le but de la fonction d'objectif est de comparer les exports aux observations et à définir un indicateur ``double`` qui pourra être utile au script d'optimisation. -Le résultat de la fonction d'objectif est stocké dans le SimulationStorage et pour être récupéré, à la fin de chaque génération, avec la méthode +Le résultat de la fonction d'objectif est stocké dans le ``SimulationStorage`` et pourra être récupéré, à la fin de chaque génération, avec la méthode ``SimulationStorage#getObjective()`` @@ -169,4 +167,4 @@ } } -Dans cette exemple, cette fonction d'optimasation aura lancé 8 simulations (4 séries de 2 simulations). +Dans cette exemple, cette fonction d'optimisation aura lancé 8 simulations (4 séries de 2 simulations).

1 0

r336 - in trunk/src/site: . rst/v4/user/tutorials
by echatellier＠users.forge.codelutin.com Jan. 29, 2018

Jan. 29, 2018

Author: echatellier Date: 2018-01-29 14:35:47 +0100 (Mon, 29 Jan 2018) New Revision: 336 Url: http://forge.codelutin.com/projects/isis-fish-docs/repository/revisions/336 Log: Ajout de la documentation des scripts d'optimisation Added: trunk/src/site/rst/v4/user/tutorials/optimization.rst Modified: trunk/src/site/site_fr.xml Copied: trunk/src/site/rst/v4/user/tutorials/optimization.rst (from rev 335, trunk/src/site/rst/v4/user/usermanual/analysisPlan.rst) =================================================================== --- trunk/src/site/rst/v4/user/tutorials/optimization.rst (rev 0) +++ trunk/src/site/rst/v4/user/tutorials/optimization.rst 2018-01-29 13:35:47 UTC (rev 336) @@ -0,0 +1,172 @@ +.. - +.. * #%L +.. * IsisFish +.. * +.. * $Id$ +.. * $HeadURL$ +.. * %% +.. * Copyright (C) 2018 Ifremer, Code Lutin +.. * %% +.. * 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% +.. - + +============ +Optimisation +============ + +Les scripts d'optimsation servent à lancer plusieurs série de simulation et évaluant à chaque itération si le script doit continuer. +Cette condition est vérifiée par une fonction d'objectif qui analyse les exports habituels des simulations par rapport aux observations renseignées +dans la base de données. + + +Script d'optimisation +===================== + +Un script d'optimisation est relativement similaire à un plan d'analyse, mais il comprend quelques méthodes en plus. Son but est de générer un +ensemble de simulation à être executée et déterminer une condition à l'arrêt du script. + +Voici l'ensemble des méthodes présentes dans le script: + * ``getNecessaryResult()`` : retourne l'ensemble des résultats devant être calculés par l'ensemble des simulations et nécessaire à l'execution du + script d'optimsation + * ``getDescription()`` : retourne une description du script à destination de l’utilisateur (affichée dans l'interface de lancement) + * ``init(OptimizationContext)`` : sert à initialiser le script d’optimisation (appelée une fois, avant le lancement du script) + * ``firstSimulation(OptimizationContext)`` : sert à générer la première génération de simulation (appelée une fois au lancement du script) + * ``nextSimulation(OptimizationContext)`` : est appelée plusieurs fois, a chaque génération de simulation + * ``endSimulation(OptimizationContext)`` : est appelée plusieurs fois, à chaque fin d’exécution d'une génération de simulation + * ``finish(OptimizationContext context)`` : appelée une fois, à la fin du script, lorsque que l'ensemble des générations de simulation ont terminé + + +Génération de simulation +------------------------ + +Dans les scripts d'optimisation, on parle de "génération de simulation" pour désigner un ensemble de simulation que le script d'optimisation +génere à chaque itération. + +Chaque génération comprend plusieurs simulation qui sont executées en parallèle. Mais les "génération de simulation" sont exeution séquantiellement. + + +OptimisationContext +------------------- + +L'objet ``OptimizationContext`` est un object qui est donné à chaque méthode du script d'otpimisation. Il permet de: + * connaitre l'état d'avancement du script + * de produire de nouvelles simulation dans la génération courante + +Liste des méthodes disponibles: + * ``context.getCurrentGeneration()`` : permet de connaitre le numéro de la génération en cours. Par exemple, au 3ème appel de ``nextSimulation()`` le + compteur sera égal à ``3`` (en prenant en compte que le compteur est égale à ``0`` dans la méthode ``firstSimulation()`` + * ``context.newSimulation()`` : crée une nouvelle simulation dans la simulation courante et la retourne sous forme de SimulationStorage (pour être + modifiée par l'utilsateur avant son lancement) + * ``context.getLastSimulations()`` : retourne l'ensemble des simulations exécutée dans la dernière génération. Les ``SimulationStorage`` retournée peuvent + être lu pour en extraire des résultats + + +Condition d'arrêt +----------------- + +Un script d'optimisation s'arrête lorsqu'il n'y a plus de simulation à executer. + +Donc, pour arrêter un script, il faut, dans la méthode ``nextSimulation(OptimizationContext)`` ne faire aucun appel à ``context.newSimulation()``. + + +Fonction d'objectif +=================== + +Une fonction d'objectif sert à retourner un indicateur sur l'execution d'une simulation. Cette fonction d'objectif est à paramêtre à définir lors +du lancement d'un script d'optimsation et peut donc être différente à chaque fois. + + +Structure +--------- + +Un script d'optimisation à des méthodes classiques aux autres scripts: + - init() pour initialiser la fonction d'objectif + - getNecessaryResult() pour définir les résultats à calculer pour le fonction d'objectif + - getDescription()pour fournir une description à l'utilsateur + +Il contient surtout une seule méthode spécifique : ``double eval(OptimizationContext context, List<MatrixND> exports, List<MatrixND> observations)``. + +Cette méthode prend en paramètres: + * le contexte de simulation + * les résultats des exports définis au lancement du script d'optimisation + * les observations définis lors du lancement du script d'optimisation + +Le but de la fonction d'objectif est de comparer les exports aux observations et à définir un indicateur ``double`` qui pourra être utile au script +d'optimisation. + +Le résultat de la fonction d'objectif est stocké dans le SimulationStorage et pour être récupéré, à la fin de chaque génération, avec la méthode +``SimulationStorage#getObjective()`` + + +Exemple +======= + +Fonction d'objectif ``Objectif3Iteration.java``. Cette fonction d'objectif est très simple. Elle retourne -1 losque que 3 générations de simulation +ont été executées. + +.. class:: java + +:: + + public class Objective3Iteration implements Objective { + + public double eval(OptimizationContext context, List<MatrixND> exports, List<MatrixND> observations) { + double result = 0; + if (context.getCurrentGeneration() >= 3) { + result = -1; + } + return result; + } + } + +Script d'optimisation ``ExampleObjectif.java``. Cet example génère des séries de 2 simulations, tant que la fonction d'objectif n'a pas retourné ``-1``. + +.. class:: java + +:: + + public class ExampleOptimization implements Optimization { + + protected boolean stopped = false; + + public void firstSimulation(OptimizationContext context) throws Exception { + for (int i = 0; i <= 2; i++) { + SimulationStorage storage = context.newSimulation(); + // modify simulation storage + } + } + + public void nextSimulation(OptimizationContext context) throws Exception { + if (!stopped) { + for (int i = 0; i <= 2; i++) { + SimulationStorage storage = context.newSimulation(); + // modify simulation storage + } + } + } + + public void endSimulation(OptimizationContext context) throws Exception { + List<SimulationStorage> lastGeneration = context.getLastSimulations(); + for (SimulationStorage simulation : lastGeneration) { + double objective = simulation.getObjective(); + if (objective <= -1) { + stopped = true; + } + } + } + } + +Dans cette exemple, cette fonction d'optimasation aura lancé 8 simulations (4 séries de 2 simulations). Modified: trunk/src/site/site_fr.xml =================================================================== --- trunk/src/site/site_fr.xml 2018-01-26 10:54:38 UTC (rev 335) +++ trunk/src/site/site_fr.xml 2018-01-29 13:35:47 UTC (rev 336) @@ -110,6 +110,7 @@ <item name="Première utilisation" href="v4/user/tutorials/firstLaunch.html"/> <item name="Paramétrisation" href="v4/user/tutorials/parameterising.html"/> <item name="Plans d'analyse" href="v4/user/tutorials/simulationPlan.html"/> + <item name="Script d'optimisation" href="v4/user/tutorials/optimization.html"/> <item name="Utilisation des APIs" href="v4/user/tutorials/useAPI.html"/> <item name="Commandes CAPARMOR" href="v4/user/tutorials/utilCaparmor.html"/> </menu>

1 0

r335 - trunk/src/site/rst/v4/user/usermanual
by jcouteau＠users.forge.codelutin.com Jan. 26, 2018

Jan. 26, 2018

Author: jcouteau Date: 2018-01-26 11:54:38 +0100 (Fri, 26 Jan 2018) New Revision: 335 Url: http://forge.codelutin.com/projects/isis-fish-docs/repository/revisions/335 Log: Update doc Modified: trunk/src/site/rst/v4/user/usermanual/inputs.rst Modified: trunk/src/site/rst/v4/user/usermanual/inputs.rst =================================================================== --- trunk/src/site/rst/v4/user/usermanual/inputs.rst 2018-01-09 11:14:27 UTC (rev 334) +++ trunk/src/site/rst/v4/user/usermanual/inputs.rst 2018-01-26 10:54:38 UTC (rev 335) @@ -291,7 +291,7 @@ .. image:: input_06_inputZonesVariables.png -L'onglet *Variables* sert à définir des informations supplémentaires, comme par exemple, l'habitât de la zone. +L'onglet *Variables* sert à définir des informations supplémentaires, comme par exemple, l'habitat de la zone. 4. **Saisie des ports** ======================= @@ -616,8 +616,8 @@ annuler les modifications effectuées sur les groupes de la population. -Onglet **Saisie des équations de population** -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +Onglet **Saisie des traits de vie** +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ .. image:: input_12_inputPopulations_tabEquation.png @@ -643,8 +643,9 @@ #. **Liste des populations** : Cette liste déroulante contient l'ensemble des équations de taux de reproduction connues pour cette espèce. -#. **Équation de taux de reproduction** : - Pour éditer sans passer par l'éditeur d'équations, l'équation de taux de reproduction. +#. **Équation de taux de reproduction (fécondité)** : + Pour éditer sans passer par l'éditeur d'équations, l'équation de taux de reproduction (fécondité). Ce paramètre n'est + pas toujours utilisé. L'utilisateur peut l'appeler dans ses scripts et équations. #. **Sauver comme modèle** pour équation de taux de mortalité naturelle pour sauver une équation de type taux de mortalité naturelle dans les scripts d'ISIS-Fish (formules/NaturalDeathRate)

1 0

r334 - trunk/src/site/rst/v4/user/usermanual
by bpoussin＠users.forge.codelutin.com Jan. 9, 2018

Jan. 9, 2018

Author: bpoussin Date: 2018-01-09 12:14:27 +0100 (Tue, 09 Jan 2018) New Revision: 334 Url: http://forge.codelutin.com/projects/isis-fish-docs/repository/revisions/334 Log: modification de la documentation pour l'immigration (coefficient -> effectif) Modified: trunk/src/site/rst/v4/user/usermanual/inputs.rst Modified: trunk/src/site/rst/v4/user/usermanual/inputs.rst =================================================================== --- trunk/src/site/rst/v4/user/usermanual/inputs.rst 2017-10-02 14:59:43 UTC (rev 333) +++ trunk/src/site/rst/v4/user/usermanual/inputs.rst 2018-01-09 11:14:27 UTC (rev 334) @@ -967,8 +967,8 @@ #. **Sélection de la zone d'arrivée** : Liste déroulante des zones d'arrivée parmi les différents aires préalablement définies. Il faut sélectionner un zone d'arrivée pour le groupe sélectionné. -#. **Coefficient d'immigration** : - il s'agit de la proportion du groupe sélectionné affectée par l'immigration. +#. **Effectif d'immigration** : + il s'agit du nombre d'individu entrant dans le groupe et la zone sélectionnés. #. **Ajouter l'immigration** : Une fois sélectionnés les paramètres précédemment cités, on appuie ici pour créer l'immigration; les paramètres de l'immigration apparaissent comme une

1 0