Installation

<dependency>
            <groupId>fr.ign.cogit</groupId>
            <artifactId>simplu3d</artifactId>
            <version>1.2-SNAPSHOT</version>
          </dependency>
          

<repository>
            <id>ign-snapshots</id>
            <name>Cogit Snapshots Repository</name>
            <url>https://forge-cogit.ign.fr/nexus/content/repositories/snapshots/</url>
            <snapshots>
              <enabled>true</enabled>
            </snapshots>
            <releases>
              <enabled>false</enabled>
            </releases>
          </repository>
          <repository>
            <id>ign-releases</id>
            <name>Cogit Releases Repository</name>
            <url>https://forge-cogit.ign.fr/nexus/content/repositories/releases/</url>
            <snapshots>
              <enabled>false</enabled>
            </snapshots>
            <releases>
              <enabled>true</enabled>
            </releases>
          </repository>
          

Première simulation

First simulation

Pour lancer une première simulation déjà prête à l'emploi, il suffit d'exécuter le code ci-dessous provenant de la classe BasicSimulator en clonant le projet SimPLU3D-tutorial qui contient des exemples de code.

Running a first ready-to-use simulation only requires to execute the following code available in the BasicSimulator class by cloning the SimPLU3D-tutorial project. It also contains some other English-commented code samples.

Afin d'exécuter ce code, vous pouvez utiliser votre environnement de développement habituel ou simplement la ligne de commande suivante : mvn exec:java -Dexec.mainClass=fr.ign.simplu3d.firstSimulation.BasicSimulator

In order to execute this code, you can either use your usual development environment or use the following command line: mvn exec:java -Dexec.mainClass=fr.ign.simplu3d.firstSimulation.BasicSimulator

          public static void main(String[] args) throws Exception {
            //Step 0 ; Defining an output existing folder
            String outputFolder = "/tmp/";
            // Step 1 : Creating the geographic environnement using the repository that contains the data
            // Load default environment (data are in resource directory)
            Environnement env = LoaderSHP.loadNoDTM(
            new File(BasicSimulator.class.getClassLoader().getResource("firstSimulation/data/").getPath()));
            // Select a parcel on which generation is proceeded
            BasicPropertyUnit bPU = env.getBpU().get(2);
            //Step 2 : Defining the regulation that will be applied during the simulation
            // Rules parameters.8
            // Distance to road
            double distReculVoirie = 2;
            // Distance to bottom of the parcel
            double distReculFond = 3;
            // Distance to lateral parcel limits
            double distReculLat = 4;
            // Distance between two buildings of a parcel
            double distanceInterBati = 0;
            // Maximal ratio built area
            double maximalCES = 0.5;
            //Instanciation of a predicate class
            SamplePredicate<Cuboid, GraphConfiguration<Cuboid>, BirthDeathModification<Cuboid>> pred = new
        SamplePredicate<>(bPU, distReculVoirie, distReculFond, distReculLat, distanceInterBati, maximalCES);
            //Step 3 : Defining the regulation that will be applied during the simulation
            // Instantiation of the sampler
        OptimisedBuildingsCuboidFinalDirectRejection oCB = new OptimisedBuildingsCuboidFinalDirectRejection();
            // Loading the parameters for the building shape generation
            String folderName = BasicSimulator.class.getClassLoader().getResource("firstSimulation/scenario/").getPath();
            String fileName = "params.json";
            SimpluParameters p = new SimpluParametersJSON(new File(folderName + fileName));
            // Run of the optimisation on a parcel with the predicate
            GraphConfiguration<Cuboid> cc = oCB.process(bPU, p, env, 1, pred);
            //4 - Writting the output
            SaveGeneratedObjects.saveShapefile(outputFolder + "out.shp", cc, bPU.getId(), 0);
          }