...version française de cette page | ...version française de cette page |
PDF version of this charter: Computree_Charter_v2018_08.pdf
This charter highlights main operating procedures of the Computree platform. It describes the goals of the platform, the rules, the different roles in the Computree community, as well as the governance and management modalities of the platform.
The use of the Computree platform, or the development of Computree plugins and libraries, implies the express acceptance of the provisions of this Charter.
Failure to comply with the dispositions of this charter may result in the exclusion of the Computree Community.
The Computree platform started in spring 2010 as part of a collaboration between the Research, Development and Innovation (RDI) department of the Office National des Forêts (ONF) and the Ecole Nationale Supérieure des Arts et Métiers (ENSAM) of Cluny, within the ANR Emerge project. Between 2010 and 2016, the core of the platform was developed and mostly maintained through ONF budget, supplemented by contributions from the ANR Emerge and Foresee projects. ONF (mainly processing algorithms), and ENSAM research contracts (mainly core of the platform) shouldered most of the programming. Initially focused on terrestrial LIDAR data processing, the platform opened itself to other data sources such as the airborne LIDAR since 2014.
In 2018, the governance and management of the platform was transferred from ONF to the Computree group, under GIP ECOFOR. The group includes a number of organizations or institutions contributing resources dedicated to the platform (staff time, material or logistical contributions, financial contribution). The “Terms of Governance, Management and Operation” section of this charter describes this aspect in detail.
This transfer of governance is motivated by the following goals:
The founding members of the Computree group are: the Office National des Forêts, the GIP Ecofor, the Institut National de l’Information Géographique et Forestière, the Institut National de la Recherche Agronomique and the University of Sherbrooke.
The Computree platform is a collaborative tool for data processing in the context of forest management, or natural environment in general. It offers a modular environment allowing mainly the treatment of remote sensed data: terrestrial LIDAR, airborne LIDAR, airborne or satellite photographs, raster data (digital terrain models, digital surface models or canopy height models)... However its processing capacities can be extended to any type of 3D geometric data, 2D, or attributes.
The main objective of Computree is to promote synergies in the development and use of data processing methods in order to describe, analyse and inventory forest stands or other natural environments. This goal is further divided into three complementary sub-goals:
The linkages between those 3 dimensions is at the heart of the Computree platform philosophy.
Though most features of the platform could accommodate other operating environments, the shared resources allocated to the management and maintenance of the platform will focus exclusively on natural environments.
The platform is built on a modular architecture that makes it easy for independent teams of the Computree community to add custom features The platform encompasses the following elements:
Several basic plugin and libraries are provided as standard with the platform and contain the essential functionalities for the creation of processing chains (in particular import/export formats).
There is no limit to the number of plugins or libraries that could be added to Computree. The system is also designed to allow the use of new interfaces, graphic or not, developed for example for specific uses or certain plugins only.
The principle of the platform is to propose, through the interfaces, the possibility for the user to create sequences of workflows, from bricks named “steps” contained in the plugins. Each step consists of applying an algorithm to input data in order to produce output data. Thus, by linking steps, potentially from different plugins, the user can compose a process adapted to his needs. Some steps can be very generic (thus usable in many contexts). Others are dedicated to a very specific use.
The processing sequence can be fully constituted and saved as a script, before immediate or delayed execution.
“Computree Community” means all physical or legal persons who develop plugins or use the Computree platform. In order to clarify the interactions within the Computree community, this charter defines several "Computree roles". The same person could have multiple roles at the same time, or over time:
The core, the standard batch interface as well as common plugins and common libraries are released under the open-source LGPL (Lesser General Public License). The standard graphical interface is made available under the General Public License (GPL).
These elements can thus be used for any professional or personal use, commercial or not, respecting the conditions of this Charter. As stated in the LGPL and GPL licenses, the platform is distributed without any guarantee, neither explicit nor implicit.
Each plugin or library (apart from common plugins) is the property of an author, group, organization, institution, company, or member of the Computree community that has created this plugin or library. The owner of the plugin has full latitude to choose the rules and modalities of dissemination and conditions of use of its plugin. The Computree standard graphical interface being under GPL license, a licensed non-GPL compatible plugin will either have to remain in internal use, or offer an alternative interface. Note that the Computree standard batch interface does not impose any such restrictions.
The platform thus hosts several components (core, interfaces, plugins, and libraries) of different nature with regard to the intellectual property rights and the rights of use attached to them.
The central elements of the platform are the subject of shared ownership between the current and past members of the group in proportion to their total contribution whatever their nature (financial amount, staff time, material resources), evaluated financially and cumulated since 1st January 2010. They include:
The addition of new elements (common plugins and libraries) to the list of central elements can only be done by the strategic committee, insofar as these elements are developed on the resources allocated to the platform. They are subject to shared ownership, though each member remains the owner of the rights on his initial contributions (integration of previous works). A list of core elements is maintained by the Strategic Committee and is included in the annual activity report. Also included in this activity report is an updated statement of contributions accumulated since January 1, 2010, of each of its active or departing members. The contributions recognized for the current year are added to the balance sheet, after unanimous vote of their accuracy by the strategic committee. This report gives the annual details of the contributions and their nature for each member who is or has been part of the group.
As for other plugins or libraries (general case), the intellectual property is managed autonomously: the membership in the Computree group gives no rights on plugins or libraries that are not part of the list of central elements.
Two committees are established to manage the Platform, and each meets once a year.
A Technical Committee, only consultative, aims to make proposals for the evolution of the platform to feed the strategic committee. This committee is led by Computree Manager and meets at least once a year. All members of the Computree group are welcome to participate, and it is also open to any Computree plugin developer. The Computree Manager reviews the evolution of the platform over the past year. It also summarizes user requests from different channels, including the Computree user forum. Finally, the members of the technical committee list the proposals for changes to the platform for the coming year and propose criteria for prioritization.
A Strategy Committee, composed of the members of the Computree Group as defined in Article I, meets at least once a year. It makes all decisions regarding the Computree Group and the management of its resources. In particular:
Only members of the Computree Group have a right to vote.
The weighting of votes in the strategic committee is proportional to all the contributions made by the member (financial amount, staff time and material resources evaluated financially), for the current year. One vote is awarded per full part of 1000 euros. Exceptionally, a member may not be awarded more than 45% of the total voting rights regardless of the amount of his contribution.
Bipartite agreements between the Computree Group Leader and the various partners set the expected level and duration (for staff time contributions) of these contributions.
The Computree Group administrative management is handled by the Computree Group Leader. Its mission is to:
The resources provided by the members of the group (and any seminar fees requested from the participants, described in Article III.5) are used for the maintenance and development of Computree core elements, the tests as well as the animation of the Computree community, dissemination and documentation of the platform.
Note that the development of plugins and libraries is not funded on resources allocated to the platform, excepting plugins and libraries listed among central elements, whose development has been validated by the strategic committee. This list is kept up to date by the Computree Manager.
The use of Computree and the resources made available to enable and facilitate the development of plugins are completely free. Online resources are made available to facilitate the independence of Computree community members. An exchange forum also aims to promote mutual support in the community.
“Plugin developers” seminars are proposed according to the needs. They are free for any plugin released under Open-Source license and remaining in the fields of application of natural environments or forest. In all other cases, they are subject to payment on invoice of seminar fees.
Each year, at least one Computree User Seminar is offered to the community, possibly several depending on demand and needs. These seminars are intended to introduce users to the use of the Computree platform. Thematic deepening seminars may also be offered. These seminars may be subject to payment on invoice of seminar fees incurred by each trainee. For ease of access, Computree User Seminars can also be offered in the training catalogue of one or more group member organizations.
The resources resulting from the organization of these seminars (if any) feed into the budget allowing the evolution of the platform. In addition, members of the Computree community are free to organize their own Computree seminars or training.
When a new member wishes to join the Computree group, a draft agreement with the Computree Group Leader - specifying, if applicable, past contributions to the core elements of the platform, and in any case the contributions planned for the period of the convention - is drafted before the meeting of the strategic committee. During the meeting, the strategic committee considers and decides on the integration of the new member by a two-thirds majority. Once the integration is validated and the agreement between the new member and the Computree Group Leader signed by both parties, the new member joins the Computree Group and sits on the Strategy Committee.
New members undertake to respect the obligations incumbent on them and the provisions of this charter.
New members commit to allocate significant resources (equivalent value greater than or equal to 5,000 € / year), over time, to maintain or develop the core elements of the Computree platform. These resources are defined in a multi-year agreement with the Computree Group Leader. They can be of different natures:
In all cases, these resources are converted into an equivalent monetary amount, in order to determine the voting rights of each member of the group, in proportion to his contribution for the current year.
In the event that one of the members fails to comply with the obligations set out in this charter, and after a formal notice from the Computree Group Leader has been ineffective for a period of three months, the Strategy Committee may decide to exclude him (by unanimity, the member at stake not participating in this vote), noting that the contributions paid are not returned to him.
In this case, the Strategic Committee mandates the Computree Group Leader to terminate the agreement with the member at stake. The termination date will be set at the end of the financial year, as far as possible.
At the expiry of the agreement of one of the members of the group, this member may automatically decide on its renewal (by amendment or new agreement), unless he has violated of the provisions of this charter.
However, if the contribution is increased by more than 50%, the strategic committee must agree to this increase (absolute majority vote, the member at stake not participating in this vote).
The voting rights will be recalculated according to the terms defined in Article III.2.
The Computree platform is made available “as is” without warranty of any kind, either express or implied, including, but not limited to, the implied warranties of merchantability and fitness for a particular purpose. The entire risk as of quality and performance of the platform is supported by the user. If the platform is defective, the users bear alone the cost of any necessary repairs.
Computree Group members are not responsible for the use made by users of the Platform or the results of the resulting analysis.
Nothing in this Charter shall be construed as constituting among the members a legal entity of any nature whatsoever or involving any kind of solidarity between the members.
The members declare that the present Charter cannot in any case be interpreted or regarded as constituting an act of society, the affectio societatis is formally excluded.
No member has the power to engage other members, nor to create obligations for other members, other than the Computree Group Leader, for the sole purpose of the assignment and to the extent of the rights which are granted to it/her/him.
| ...version française de cette page |
| Back to How Tos list |
| ...version française de cette page |
The Batch mode is a manager for alternative interfaces to Standard Graphical Interface, dedicated to more automated and repetitive treatments.
When executing the Batch mode, it adds an icon to the taskbar: 
. A right-click on this icon gives the ability to run a Batch Interface.
Each Batch Interface contains features for specific treatments.
| Previous (Available plugins) | Back to summary |
| ...version française de cette page |
The following sections describe the functionality of the interface
Here is a Pratical Work: Training - use of ComputreeGUI interface
| Previous (Item types) | Back to summary | Next (Available plugins) |
| ...version française de cette page |
So far we have seen how to create a steps tree, execute it and view the results.
The objective is to process point clouds using automatic algorithms contained in steps.
However, it is sometimes necessary to manually modify results. This is why Computree proposes the concept of actions.
An action is a tools using views a way to query and / or modify a result containing certain types of items.
The actions implemented in the plugins can be used in two ways (one action may sometimes be used in both modes):
The interactive mode is managed by the Action Manager (Actions). It lists all the available actions for the active view.
Just check the desired action. *Only one action can be used at once *.
Action Manager:
Actions are classified by type. When checked it becomes active, and all others become inactive.
In steps mode, the actions are not visible to the user, because it is a step that needs it during its execution.
In this case, when the step is performed, at a given time it is interrupted, and gives control to the user. The icon 
becomes active (colored).
In general, a message warns the user to proceed. Most of the time, it opens a specific view, providing a toolbar adapted to its function.
Once the user has performed the operation required, simply click on to launch the result of the end of the step processing based on the interactive job done.
You can add items with the Model Manager or the Items Manager in the view created by the action, together with displays made by the action itself.
[[plugin-base:En_wiki#Actions provided by the plugin|Go to the Wiki page of Base Plugin]]
| Previous (Views functionning) | Back to GUI summary | Next (Using Exporters) |
| ...version française de cette page |
Exporters allow, as their name indicates, to export items.
Like actions, Exporters implemented in plugins can be used in two ways:
To use the interactive mode, start by selecting items in a view.
Then click on the button !{height:24px}!upload.png! in the toolbar of the view (you will have to select export file path).
To use the step mode, you must add the desired “exporter step” ( using the Step Manager) after the step that produced the results containing the items you want to export.
Thus, in the Step Manager right_click on the step, choose the sub-menu for the appropriate plugin, and in exporter category choose the wanted exporter format.
Example: exporters of Base Plugin:
Then a result configuration window appears to select the items you want to export.
[[plugin-base:En_wiki#Exporters provided by the Base plugin|Go to the Wiki page of Base Plugin]]
The icon !{width:24px}preferences- system.png! in main toolbar, provides access to general options. To date there are only one option available: the choice of the decimal separator (for import / export in text format):
| Previous Page (Using Actions) | Back to GUI summary |
| ...version française de cette page |
ComputreeGUI is the standard Computree interface. It allows management of steps and their results, but also to customize their display in 3D or tabular views.
The main tool bar (2) offer icons most of the features present in the menu bar (1). These features will be described in different parts of this documentation.
The Step Manager (3) is central because it allows you to create and execute Steps tree. It, and also the Log windows (10), would be described in detail in Managing processing.
The Model Manager (4) and the Item configurator (5) would be described in Displaying items.
The 3D (6) and tabular (7) views, and the Views synchronization manager (9) will be described in Views functionning.
The Action Manager (8) will be presented in Using actions.
Components 3 to 5 and 8 to 10 are dockable components, which can be moved, stacked (as tabs) or used as floating windows. You just have to left-click on the title bar and move it, holding the click, to their desired destination. The Window menu provides two default options for organization of these components :
You can customize the organization of composants, by moving them.
The arrangement of components is stored in the config.ini file when closing Computree, and is would be loaded for the next session of Computree.
If a component has been closed, it can be recalled using the window menu.
About plugins windows list loaded plugins. For each plugin it gives available steps. For each step it gives IN and OUT models of results.
The Reload button is used to restart the loading of plugins, and in particular for changing the path to plugin directory, if it is not at the default location.
If you click on a step and the on the Step Info button, it open a window with the following information:
| Back to GUI summary | Next Page (Managing processing) |
| ...version française de cette page |
The Model Manager is used to view the OUT result model of a result. When you click on the check-box of *result *in the Step Manager, the model becomes active in the Model Manager.
However, the combo-box at the top of Model Manager allows you to choose among the results models, the one you want to view. In the combo-box, for each result, the name and the number of the parent step is shown in brackets (for linking with the Step Manager).
In the Model Manager, the first level gives the name of the result.
This level contains the hierarchy levels corresponding to groups and items, each with a check-box. These check-boxes are used to set the display of items of interest in the current view.
In the Model Manager, there is a column for each view of the the views area. The column number is the number of the view.
The group levels are recognizable to the small arrow before their name, which will hide / show children elements. The item levels cannot have children elements, so they do not have this arrow.
When you check a group level, as it does not contain data itself, it will instead triggers the display of its children elements recursively.
By a *right-click*on a level of the hierarchy of models, you get a context menu options to manage colorization of items displayed:
Where Model Manager is used to manage the display of all the items of the same level, the Items Manager allows for more accurately display each item in considered level.
Each line of the Items Manager contains the information of a group or item. Elements are structured hierarchically. Horizontal arrow at the beginning of the line (in the case of a group) allow to unfold the hierarchy and display lines for children elements.
The Items Manager has several columns:By a right-clicking on a line , you get a context menu:
The Item Configurator adjusts the display options of items present in at least one view.
At the top, a combo-box lists all classes of items currently displayed in at least one of the views. It allows to select the item type for which you want to set the display options. These options (changeable characteristics) are presented in two columns:
In the general case, the options are managed uniformly to all instances of the same class of item.
However, for certain classes of items (2D or 3D grids for example), the parameters can be set for each instance specifically. In this case the same class appears once per instance in the combo-box, identified by the identifier of the item.
| Previous (Managing processing) | Back to GUI summary | Next (Views functionning) |
| ...version française de cette page |
The steps tree is managed in the Step Manager. This component allows you to create a valid step hierarchy. Once processing is performed, each step contains also the results it has created.
Step Manager*after creating a *steps tree, but before processing:
Step Manager during the processing of the steps tree:
Step Manager after the end of processing:
The first column contains the name of the steps, with arrows at left to collapse the hierarchy affiliated with each step.
After processing, it also contains the name of the results produced.
The second column contains a progress bar to monitor the progress of processing.
The third column stores processing time of steps (updated at the same time that the progress bar).
In the case of results, this column contains a checkbox. Checking this box, allows you to “send” the result to Model Manager. This has the effect of displaying the OUT result model of the step in the Model Manager (which will manage its display, as discussed in section Displaying items).
The fourth column allows for steps to enable debug mode.
To start the execution of the steps tree you must click on the button 
. It can also suspend using the button 
.
To export the tree steps as a script, you must click on the button 
. Scripts can then be loaded using the button 
.
To initiate a sequence of steps, we must first insert an initial step.
It can be inserted:
. In this case, a file selection window opens, and loads data, once the file selection has been validated.
. In this case you must select the step in the plugins sub-menu that contains it. This step type allows for more complex loading (multiple files of different types, settings before loading, data creation...).
Once inserted a starting point, adding other steps is done using the context menu: Right-click on a step for which you want to add a child step.
Elements of the step context menu :
The first part of the menu allows modifying the current step:
The second part of the menu contains a sub-menu for each plugin loaded. This sub-menu contains the list of steps for the considered plugin. Those in gray*are not compatible with the results produced by the current step. The others can be added. By leaving the mouse for a moment, a tool tip briefly describing the function of the step is obtained. By clicking, the step is added, what causes the display of the configuration window for *input results (if necessary), then the window for setting step parameters of the new child step.
Once added, the step is (most of the time) to be configured.
First step analyzes the results of the parent step (or even the entire hierarchy, if the recursive search is active for the considered IN result model). This analysis selects result( s) consistent as input.
This selection works by comparing the IN results models of the added step with OUT results models of candidates results.
In the case where multiple results are valid, the window to configure the input results is open:
The left side lists candidates results, sorted by searched IN results models of the step. The number of the step bearing each result is shown in parentheses.
Double-clicking on a result will transfer the selected result as a validated correspondence to the right side (you can also drag the result from the left side to the right side).
The right side displays the results matches validated above. On the right-bottom part, it is possible to select alternatives items / groups levels, if more than one possibility is valid.
Explanation of the concept of Turns
Once all choices done, simply click OK to validate the configuration if input results.
Then, if necessary, the window for setting step parameters opens. It contains all the adjustable parameters of the algorithm to run. For example their are the parameters for the OE_StepExtractSoil03 step:
Once the parameters are selected and approved, the step is actually added in the steps tree.
| Previous (General Organization of the interface) | Back to GUI summary | Next (Displaying items) |
| ...version française de cette page |
You can add a new 3D view by clicking on the button 
in the main toolbar.
The 3D view is the most used in ComputreeGUI, because it allows to view items created by the steps in three dimensions. It uses OpenGL, valuing the graphical component QGLViewer ( http://www.libqglviewer.com/). 3D navigation is as follows:
The toolbar provides access to additional features.
Button 
allows to manage views (camera settings). Details on views
Button 
provides access to Exporters for selected items. This functionality is described in the Using Exporters.
Button 
allows you to set preferences for the view. Details preferences fo view
Button 
can apply a color to points / faces / half-edges attributes. Details on coloring attributes
/ 
/ 
allows to manage graphic optimization (as in the dialog obtained by button ) :
: reduction of points number during moves : reduction of points number all the time : always draw all points ever when movingThe buttons suite 
/ 
/ 
allows to manage points size (1 / 2 / 3 pixels).
Button 
launch the computing of an octree. This acceleration structure allows quicker selections (particularly for points selection).
Button 
opens a menu with following icons: 
. Each icon defines camera orientation according to the selected point of view.
Button 
adjusts the extends of view to the bounding box of the displayed items. This allows also to define the extension of the area displayed by the camera. It recalculates the front and back clipping planes (nothing is drawn forward / beyond these planes). This button works only with items, for which bounding box is correctly set (this is always the case with items containing points).
Button 
set the center of rotation for the camera on the center of the selected item / points.
Button 
set the center of rotation of the camera on the center of the bounding box of all displayed items.
Button 
set the center of rotation of the camera to (0,0,0)
Button 
allows to manually adjust all camera settings. Details on camera setting
It is possible to synchronize cameras of multiple 3D views: so when you change one view, the other views adjust to be synchronized from the same point of view.
You just have to activate the button Sync of the toolbar of each view you want to synchronize. The button is then modified in Sync.
You can add a new 2D view by clicking the button 
in the main toolbar.
A 2D view works just like a 3D view, but the camera is locked on a point of view from the top.
Moreover the projection is *orthoscopic *, removing any perspective effect.
You can add a new tabular view by clicking the button 
in the main toolbar.
A tabular view displays attribute information of the items it contains. Items of different classes can be added to the same table view.
Each line displays the data of an item with a column for each field.
In all cases the column 1 contains the unique identifier of the item, and column 2 the name of its class.
In the general case we add items to a table view in the same way as a 3D view:
A table view can also operate in synchronization mode. In this case it synchronizes the table view with one or several 3D views (or other). Then any item selected in one view is also automatically added to the table view (if an item is deselected it is removed from the table view also).
To synchronize views with the table view, you must click on the button... Sync with, and then check the views that you want to synchronize.
It is possible to delete the contents of all views by clicking the button 
.
View menu is used to rearrange views in the view area:
| Previous (Displaying items) | Back to GUI summary | Next (Use Actions) |
| ...version française de cette page |
| Previous (Standard Graphical Interface) | Back to summary | Next (Batch mode) |
| ...version française de cette page |
| Back to How Tos list |
| ...version française de cette page |
Computree includes items of different types, to manage different types of data necessary for the algorithms developed. A number of standard types of items are available in the core, what allow compatibility between plugins.
Computree is designed to handle 3D point clouds. As such points have a specific place in the platform. And points (class CT_Point) are not items to optimize the memory management.
A point is simply an array of three decimal numbers (float, 7 significant digits) containing its coordinates (x , y, z). All points created in a session are grouped in a points repository and indexed continuously.
It is expected in the short term to integrate a system of coordinates offsets to avoid this problem . This will be particularly necessary for the use of aerial LiDAR data.
To manage / display the points, they are managed within “containing points items”, which inheriting the class CT_AbstractItemDrawableWithPointCloud.
There are two types of items like this so far:
On the same model as points, Computree can handle meshes. A mesh is constituted of points, faces and half edges. Each of these elements is operated similarly to the point (they are not items). There is therefore a repository of faces and a repository of half-edges.
As for points, there is a type of item managing the arrangement of points, faces and half-edges : the mesh model (class CT_MeshModel ). It will manage the construction, modification and display of individual elements of the mesh.
We discussed about the items for storing 3D information for points, faces and half-edges. However, data associated with these elements, such as intensity, color or normal are frequently used.
So there are types of items responsible for storing the information related to the mentioned elements: the attributes.
There is an item type attribute for each crossing type of data / element type.
To date, Computree handle following types of attributes:
Computree offers a variety of types of items to manage 3D geometric shapes on a common logic.
Thus there is a type of item for each geometric shape, inheriting all of the class CT_AbstractShape:
It is expected in the medium term to add other geometric shapes : 3D polygon, rectangle, cube, cone, bezier curves...
These classes of items are templates, so they can be declined for various types of data in the cells.
These structures are working in a very similar way. It handle missing values (except in the case of booleans).
There exist more types of items for specific uses:
| Previous page(General Presentation) | Back to summary | Next (Standard Graphic Interface) |
| ...version française de cette page |
This tutorial shows how to :
Please refer to tutorial HT1 - Load, visualize, crop and export a T-Lidar point cloud at the Load a ploint cloud section.
Please refer to tutorial HT1 - Load, visualize, crop and export a T-Lidar point cloud at the Plot extraction section.
The PB_stepReducePointsDensity step is found in the base plugin (base / Points clouds / Points density reduction).
If you are using multiple scans, it is recommended to add a step for point density reduction to decrease calculation time. Depending on your computer performances, a 0.5 or 1 cm Grid resolution should be fine.
Please refer to tutorial HT2 - Create a Digital Terrain Model from a T-Lidar point cloud.
The OE_StepHorizontalClustering04 step is found in the onfensamv2 plugin (onfensamv2 / Clustering by horizontal slices)
This step creates horixontal clusters. The scene is divided in horizontal layers of a specified Thickness. Then, for each layer, points are gathered in clusters according to the distance between them. The Maximum distance between two points of the same group must be indicated.
Results of the horizontal clustering:
The OE_StepFilterClustersBySize step is found in the onfensamv2 plugin (onfensamv2 / Filtering of clusters by points number)
This step filters undersized clusters. Clusters with a number of points strictly lower than the Minimum points number are eliminated.
The OE_StepDetectSection07 step is found in the onfensamv2 plugin (onfensamv2 / Vertical merging of clusters in logs)
This step verticaly aggregates clusters in sections (logs). A Vertical distance threshold is indicated to compare clusters in pairs. If both clusters’ bounding boxes intersect on that distance threshold, clusters are merged. A log stops when there is a vertical break in the cluster. Scan occlusions or presence of a branch are commun causes.
Results of the clusters merging in logs:
The OE_StepFilterGroupsByGroupsNumber step is found in the onfensamv2 plugin (onfensamv2 / Filtering lvl 1 groups / number of lvl 2 groups)
This generic method removes groups (logs) that have a poor number of subgroups (clusters). Level 1 groups (logs) are eliminated if they got an insufficient Level 2 number of groups (clusters). This step is used to clear most of the small branches and false logs.
Results of the log filtering:
The OE_StepMergeNeighbourSections04 step is found in the onfensamv2 plugin (onfensamv2 / Merging of parallel logs)
This step merges adjacent logs. When there is occlusion in the point cloud, branches can be cut so that two logs are created instead of one:
The OE_StepMergeEndToEndSections04 step is found in the onfensamv2 plugin (onfensamv2 / Merging of aligned logs)
This step merges logs that are aligned in direction. The step operates this way (see also the technical diagram below):
Technical diagram:
Results of the fusion:
The OE_StepSetFootCoordinatesVertically step is found in the onfensamv2 plugin (onfensamv2 / Addition od a base coordinante by log // DTM)
There are no parameters needed. This step sets coordinates for tree positions by projecting the lowest cluster on the MNT.
The OE_StepFitAndFilterCylindersInSections step is found in the onfensamv2 plugin (onfensamv2 / Fitting / Filtering of cylinders by log)
This step creates cylinders and filters them depending of their goodness of fit. The tool requires a Minimum radius and Maximum radius so that small or large trees are not represented. Cylinders can be filtered on the Absolute error and/or the Relative error. They also can be filtered on their verticality, a Maximum vertical angle from solar zenith must be specified.
Results of the cylinder fitting:
The OE_StepExtractDiametersFromCylinders step is found in the onfensamv2 plugin (onfensamv2 / Computing of cylinders mean diameter by log)
This tool compute trees’ diameter at breast height (DBH). In order to do that, a cercle is adjusted on a previously created cylinder. A Bottom height and a Top height for evaluation are specified. Cercles radii are calculated between these values in order to calculate a regression. The Reference height value (generally 1.30 meters) is interpolated of this regression. The Maximal taper is used to insure that no abberant cylinders are used in the calculation. A Minimum number of cylinders to adjust a circle is also specified.
To visualize the adjusted cercles , you must activate the results in the Step and Model managers.
To visualize the results attributes, activate 
Information ItemDrawable in the Action tab and then select an object.
The PB_CSVExporter step is found in the base plugin (base / Exporters / Export d’attributs (csv))
First, select the input result.
Then, drag and drop attributes you wish to include in the file.
Finally, specify the path and file name.
| Back to How Tos list |
| ...version française de cette page |
| Back to How Tos list |
| ...version française de cette page |
How to use Computree
Video: https://www.youtube.com/watch?v=zucR-UHyR9Y
Detailed pdf Tutorial: Tutorial_01_EN.pdf
In a command invite, type:
CompuTreeBatch -script "script_name.xsct2" -startSteps
| ...version française de cette page |
How to use Computree
In a command invite, type:
CompuTreeBatch "script_name.xsct2"
attachment:Tutorial_DATA01...
attachment:Tutorial_TLS01...
attachment:Tutorial_TLS02...
attachment:Tutorial_TLS03...
| ...version française de cette page |
This tutorial shows how to :
Please refer to tutorial HT1 - Load, visualize, crop and export a T-Lidar point cloud.
To add a step, right click on the previous one and then select the tool. Select the onfensamv2 plugin, and then the Soil / vegetation segmentation → DTM step.
Tool steps and parameters:
Here is an exemple of a Digital terrain Model (DTM):
Please refer to tutorial HT1 - Load, visualize, crop and export a T-Lidar point cloud.
| Back to How Tos list |
| ...version française de cette page |
To install Computree, first download the version for your system in the Documents section:
Unzip the archive where you want to install Computree.
On Windows, just create a shortcut (right click, create a shortcut) to CompuTreeGui.exe executable file.
Under Ubuntu, creating the shortcut requires a few extra steps (Ubuntu version 13.04 and later).
sh createlauncher.sh
Otherwise it is always possible to launch Computree directly from a terminal by typing, in the installation directory of Computree, the following command:
sh CompuTreeGui.sh
| Previous (Item types) | Back to summary | Next (Standard Graphic Interface) |
| ...version française de cette page |
To install Computree, download the version for your system in the Documents section:
Unzip the archive where you want to install Computree.
On Windows, just create a shortcut (right click, create a shortcut) to CompuTreeGui.exe executable file.
Under Ubuntu, creating the shortcut requires a few extra steps (Ubuntu version 13.04 and later).
sh createlauncher.sh
Otherwise it is always possible to launch Computree directly from a terminal by typing, in the installation directory of Computree, the following command:
sh CompuTreeGui.sh
| ...version française de cette page |
You can download Computree for Windows 7/8/10 64 bits
Unzip the archive where you want to install Computree.
For Linux, Computree must be compiled from source code, as shown here
On Windows, just create a shortcut (right click, create a shortcut) to CompuTreeGui.exe executable file.
Known problem: Computree does not seem to work with Intel HD graphics cards.
Under Ubuntu, creating the shortcut requires a few extra steps (Ubuntu version 13.04 and later).
sh createlauncher.sh
Otherwise it is always possible to launch Computree directly from a terminal by typing, in the installation directory of Computree, the following command:
sh CompuTreeGui.sh
| ...version française de cette page |
This section presents the philosophy and important concepts of Computree.
The goal of Computree is to allow the processing of 3D points clouds, in order to extract useful information, as for example:
The platform is design in a Research and Development approach. The main idea is for the user to create interactively an algorithmic sequence allowing from loaded data, to obtain wished results. This sequence, or more accurately this hierarchical tree (it is possible to have parallel algorithmic ramifications), is decomposed in unit algorithmic steps, managing specific processing.
Steps are brought together in plugins, what allow to easily enrich the platform with new processing.
After execution of the algorithmic sequence, transitional results of each unit step are available, exportable and displayable. It allow a deep analysis of processing quality.
The platform has been developed with the following philosophy:
The goal is so to allow to separate teams to collaborate in 3D forest scenes processing.
But even if the platform allows a Research collaborative approach, it is also designed to permit an easy transition of developped methods in a production context (in forest management for example). Indeed, the system allows an easy implementation of dedicated interface for specific needs, using Computree core and plugin transparently.
The Computree platform is composed of following elements:
In order to process data, Computree use a step tree, exportable as a script (.xsct2 extension). The root of the step tree is a loading or a data creation step. After that, each step is attached to a mother step. The step tree can be completely constructed before execution (allowing batch or delayed processing).
Steps are implemented in (independent) plugins. Each step take as input the results of its mother step, and generate other results as output.
Results store data for itself. In order to allow chaining independently developed steps, results store data in generic elements defined in the Computree core.
These elements are of two different kind:
On this diagram, a result structure in represented, showing the structuring by groups, and data storage in items hosted in these groups. It should be noted that for each group level, the step can produce an undetermined number of instance for this structure. So if the algorithm has found n (forest) trees, the structure would be created n times, containing each time differents points and cylinders, and also a variable number of branches for each tree.
In order for the step tree to be completely created before execution, it is necessary for the steps to communicate together, to determine their compatibility.
To do that, each step has its own OUT result model describing its structure:
On the other side, steps have IN result models, which are like mandatory result structures needed as input for the step to process. These IN result models are compared to OUT result models of previous step, to decide if it could be used as input.
On this diagram, steps 1 and 3 come from one plugin, whereas step 2 comes from another one. Red arrows show the succession of steps. Blue arrows shows the creation of results by the step. Black arrows represent the compatibility testing done by one step, thanks to its in results models, compared to out results models of previous step results, candidate as input.
Plugins can extends Computree functionality, providing elements of different kind:
| Back to summary | Next Page (Items types) |
| ...version française de cette page |
This tutorial shows how to:
This platform operates in steps that are displayed in the StepManager window. To open a file, you must add a new step. Use the 
button and select the .xyb file.
To actually begin charging the file, press the 
button.
When a step execution is completed, the progressing bar is full and the result can be diplayed by activating the Result checkbox in the Step manager window :
You may notice that subresults are created as well in the Model manager :
To view a particular element, activate the corresponding checkbox in the Model manager window. To display scan points in the 3D view, check the Scene box.
N.B. : Use the 
button to ajust camera view to visible elements.
In the 3D view, you can manually adjust view using the left click button (rotation), the right click button (translation) and the scroll wheel (zoom).
Exemple for another perspective :
The points intensity can also be displayed. In order to do that, use the 
button that gives access to the Configure colors window :
Click on the Apply button to display intensity :
There are different possibilities in order to extract a portion of the point cloud.
The HT1_Load_Crop_Export_Cloud.xsct2 script uses two of these methods :
The OE_StepExtractPlot tool takes as parameters :
The TK_StepExtractBox tool takes as parameters :
The 
button enables you to export a point cloud to a specified format.
| Back to How Tos list |
| ...version française de cette page |
Documentation summary
| Back to summary |
| ...version française de cette page |
[[computreedevtools:En_quickstart| To access the procedure for setting up a development environment for Computree, clic here]]
This procedure describes:
[[computreedevtools:Fr_Wiki| The ComputreeDevTools project also provides: (click here to access it)]]
| ...version française de cette page |
[[computreedevtools:En_quickstart| To access the procedure for setting up a development environment for Computree, clic here]]
This procedure describes:
[[computreedevtools:Fr_Wiki| The ComputreeDevTools project also provides: (click here to access it)]]
| ...version française de cette page |
This section includes How Tos describing how to perform certain operations in Computree. This is mainly to describe what sequence of steps, from standard plugins, you should use to get desired information. Generally sample data and script are provided.
Available How Tos:
| Back to summary |
| ...version française de cette page |
Computree is a processing platform for 3D points clouds, obtained with LIDAR or photogrammetry. It aims to regroup algoritms for forests scenes analysis, in order to extract data on structure of trees and stands.
It is managed by the ONF (http://www.onf.fr), in partnership with the ENSAM in Cluny (http://www.ensam.fr/fr/centres_et_instituts/centre_cluny).
| ...version française de cette page |
| Computree is a processing platform for 3D points clouds, obtained with LIDAR (Light Detection And Ranging) or photogrammetry. It aims to regroup algoritms for forests scenes analysis, in order to extract data on structure of trees and stands. | |
| It is managed by the ONF (http://www.onf.fr), in partnership with the ENSAM in Cluny (http://www.ensam.fr/fr/centres_et_instituts/centre_cluny). | |
| Official website : computree.onf.fr | |
| Presentation video of Computree (in French) | |
| ...version française de cette page |
| Computree is a processing platform for 3D points clouds, obtained with LIDAR (Light Detection And Ranging) or photogrammetry. It aims to regroup algoritms for forests scenes analysis, in order to extract data on structure of trees and stands. | |
| The platform is managed by Computree Group: | |
   |
|
  |
|
| Official website : computree.onf.fr | |
| Presentation video of Computree (in French) | |
 ...version française de cette page |
Reminder: Using Computree implies acceptance of the Computree Charter
The executable version of Computree is available for Windows 7/8/10 64bits only.
For other environments (Linux in particular), please refer to the compilation instructions: [[computreedevtools:En_quickstart|to the compilation instructions]].
To install Computree :
Known problem: Computree seems not to work with some “old” Intel HD graphics cards (OpenGL problem not specific to Computree).
N.B.: You must then restart CompuTreeGui for the plugins to be taken into account (or use the menu About / Plugins / Reload Plugins).
| ...version française de cette page |
| ...version française de cette page |
PDF version of this charter: Computree_Charter_v2018_08.pdf
This charter highlights main operating procedures of the Computree platform. It describes the goals of the platform, the rules, the different roles in the Computree community, as well as the governance and management modalities of the platform.
The use of the Computree platform, or the development of Computree plugins and libraries, implies the express acceptance of the provisions of this Charter.
Failure to comply with the dispositions of this charter may result in the exclusion of the Computree Community.
The Computree platform started in spring 2010 as part of a collaboration between the Research, Development and Innovation (RDI) department of the Office National des Forêts (ONF) and the Ecole Nationale Supérieure des Arts et Métiers (ENSAM) of Cluny, within the ANR Emerge project. Between 2010 and 2016, the core of the platform was developed and mostly maintained through ONF budget, supplemented by contributions from the ANR Emerge and Foresee projects. ONF (mainly processing algorithms), and ENSAM research contracts (mainly core of the platform) shouldered most of the programming. Initially focused on terrestrial LIDAR data processing, the platform opened itself to other data sources such as the airborne LIDAR since 2014.
In 2018, the governance and management of the platform was transferred from ONF to the Computree group, under GIP ECOFOR. The group includes a number of organizations or institutions contributing resources dedicated to the platform (staff time, material or logistical contributions, financial contribution). The “Terms of Governance, Management and Operation” section of this charter describes this aspect in detail.
This transfer of governance is motivated by the following goals:
The founding members of the Computree group are: the Office National des Forêts, the GIP Ecofor, the Institut National de l’Information Géographique et Forestière, the Institut National de la Recherche Agronomique and the University of Sherbrooke.
The Computree platform is a collaborative tool for data processing in the context of forest management, or natural environment in general. It offers a modular environment allowing mainly the treatment of remote sensed data: terrestrial LIDAR, airborne LIDAR, airborne or satellite photographs, raster data (digital terrain models, digital surface models or canopy height models)... However its processing capacities can be extended to any type of 3D geometric data, 2D, or attributes.
The main objective of Computree is to promote synergies in the development and use of data processing methods in order to describe, analyse and inventory forest stands or other natural environments. This goal is further divided into three complementary sub-goals:
The linkages between those 3 dimensions is at the heart of the Computree platform philosophy.
Though most features of the platform could accommodate other operating environments, the shared resources allocated to the management and maintenance of the platform will focus exclusively on natural environments.
The platform is built on a modular architecture that makes it easy for independent teams of the Computree community to add custom features The platform encompasses the following elements:
Several basic plugin and libraries are provided as standard with the platform and contain the essential functionalities for the creation of processing chains (in particular import/export formats).
There is no limit to the number of plugins or libraries that could be added to Computree. The system is also designed to allow the use of new interfaces, graphic or not, developed for example for specific uses or certain plugins only.
The principle of the platform is to propose, through the interfaces, the possibility for the user to create sequences of workflows, from bricks named “steps” contained in the plugins. Each step consists of applying an algorithm to input data in order to produce output data. Thus, by linking steps, potentially from different plugins, the user can compose a process adapted to his needs. Some steps can be very generic (thus usable in many contexts). Others are dedicated to a very specific use.
The processing sequence can be fully constituted and saved as a script, before immediate or delayed execution.
“Computree Community” means all physical or legal persons who develop plugins or use the Computree platform. In order to clarify the interactions within the Computree community, this charter defines several "Computree roles". The same person could have multiple roles at the same time, or over time:
The core, the standard batch interface as well as common plugins and common libraries are released under the open-source LGPL (Lesser General Public License). The standard graphical interface is made available under the General Public License (GPL).
These elements can thus be used for any professional or personal use, commercial or not, respecting the conditions of this Charter. As stated in the LGPL and GPL licenses, the platform is distributed without any guarantee, neither explicit nor implicit.
Each plugin or library (apart from common plugins) is the property of an author, group, organization, institution, company, or member of the Computree community that has created this plugin or library. The owner of the plugin has full latitude to choose the rules and modalities of dissemination and conditions of use of its plugin. The Computree standard graphical interface being under GPL license, a licensed non-GPL compatible plugin will either have to remain in internal use, or offer an alternative interface. Note that the Computree standard batch interface does not impose any such restrictions.
The platform thus hosts several components (core, interfaces, plugins, and libraries) of different nature with regard to the intellectual property rights and the rights of use attached to them.
The central elements of the platform are the subject of shared ownership between the current and past members of the group in proportion to their total contribution whatever their nature (financial amount, staff time, material resources), evaluated financially and cumulated since 1st January 2010. They include:
The addition of new elements (common plugins and libraries) to the list of central elements can only be done by the strategic committee, insofar as these elements are developed on the resources allocated to the platform. They are subject to shared ownership, though each member remains the owner of the rights on his initial contributions (integration of previous works). A list of core elements is maintained by the Strategic Committee and is included in the annual activity report. Also included in this activity report is an updated statement of contributions accumulated since January 1, 2010, of each of its active or departing members. The contributions recognized for the current year are added to the balance sheet, after unanimous vote of their accuracy by the strategic committee. This report gives the annual details of the contributions and their nature for each member who is or has been part of the group.
As for other plugins or libraries (general case), the intellectual property is managed autonomously: the membership in the Computree group gives no rights on plugins or libraries that are not part of the list of central elements.
Two committees are established to manage the Platform, and each meets once a year.
A Technical Committee, only consultative, aims to make proposals for the evolution of the platform to feed the strategic committee. This committee is led by Computree Manager and meets at least once a year. All members of the Computree group are welcome to participate, and it is also open to any Computree plugin developer. The Computree Manager reviews the evolution of the platform over the past year. It also summarizes user requests from different channels, including the Computree user forum. Finally, the members of the technical committee list the proposals for changes to the platform for the coming year and propose criteria for prioritization.
A Strategy Committee, composed of the members of the Computree Group as defined in Article I, meets at least once a year. It makes all decisions regarding the Computree Group and the management of its resources. In particular:
Only members of the Computree Group have a right to vote.
The weighting of votes in the strategic committee is proportional to all the contributions made by the member (financial amount, staff time and material resources evaluated financially), for the current year. One vote is awarded per full part of 1000 euros. Exceptionally, a member may not be awarded more than 45% of the total voting rights regardless of the amount of his contribution.
Bipartite agreements between the Computree Group Leader and the various partners set the expected level and duration (for staff time contributions) of these contributions.
The Computree Group administrative management is handled by the Computree Group Leader. Its mission is to:
The resources provided by the members of the group (and any seminar fees requested from the participants, described in Article III.5) are used for the maintenance and development of Computree core elements, the tests as well as the animation of the Computree community, dissemination and documentation of the platform.
Note that the development of plugins and libraries is not funded on resources allocated to the platform, excepting plugins and libraries listed among central elements, whose development has been validated by the strategic committee. This list is kept up to date by the Computree Manager.
The use of Computree and the resources made available to enable and facilitate the development of plugins are completely free. Online resources are made available to facilitate the independence of Computree community members. An exchange forum also aims to promote mutual support in the community.
“Plugin developers” seminars are proposed according to the needs. They are free for any plugin released under Open-Source license and remaining in the fields of application of natural environments or forest. In all other cases, they are subject to payment on invoice of seminar fees.
Each year, at least one Computree User Seminar is offered to the community, possibly several depending on demand and needs. These seminars are intended to introduce users to the use of the Computree platform. Thematic deepening seminars may also be offered. These seminars may be subject to payment on invoice of seminar fees incurred by each trainee. For ease of access, Computree User Seminars can also be offered in the training catalogue of one or more group member organizations.
The resources resulting from the organization of these seminars (if any) feed into the budget allowing the evolution of the platform. In addition, members of the Computree community are free to organize their own Computree seminars or training.
When a new member wishes to join the Computree group, a draft agreement with the Computree Group Leader - specifying, if applicable, past contributions to the core elements of the platform, and in any case the contributions planned for the period of the convention - is drafted before the meeting of the strategic committee. During the meeting, the strategic committee considers and decides on the integration of the new member by a two-thirds majority. Once the integration is validated and the agreement between the new member and the Computree Group Leader signed by both parties, the new member joins the Computree Group and sits on the Strategy Committee.
New members undertake to respect the obligations incumbent on them and the provisions of this charter.
New members commit to allocate significant resources (equivalent value greater than or equal to 5,000 € / year), over time, to maintain or develop the core elements of the Computree platform. These resources are defined in a multi-year agreement with the Computree Group Leader. They can be of different natures:
In all cases, these resources are converted into an equivalent monetary amount, in order to determine the voting rights of each member of the group, in proportion to his contribution for the current year.
In the event that one of the members fails to comply with the obligations set out in this charter, and after a formal notice from the Computree Group Leader has been ineffective for a period of three months, the Strategy Committee may decide to exclude him (by unanimity, the member at stake not participating in this vote), noting that the contributions paid are not returned to him.
In this case, the Strategic Committee mandates the Computree Group Leader to terminate the agreement with the member at stake. The termination date will be set at the end of the financial year, as far as possible.
At the expiry of the agreement of one of the members of the group, this member may automatically decide on its renewal (by amendment or new agreement), unless he has violated of the provisions of this charter.
However, if the contribution is increased by more than 50%, the strategic committee must agree to this increase (absolute majority vote, the member at stake not participating in this vote).
The voting rights will be recalculated according to the terms defined in Article III.2.
The Computree platform is made available “as is” without warranty of any kind, either express or implied, including, but not limited to, the implied warranties of merchantability and fitness for a particular purpose. The entire risk as of quality and performance of the platform is supported by the user. If the platform is defective, the users bear alone the cost of any necessary repairs.
Computree Group members are not responsible for the use made by users of the Platform or the results of the resulting analysis.
Nothing in this Charter shall be construed as constituting among the members a legal entity of any nature whatsoever or involving any kind of solidarity between the members.
The members declare that the present Charter cannot in any case be interpreted or regarded as constituting an act of society, the affectio societatis is formally excluded.
No member has the power to engage other members, nor to create obligations for other members, other than the Computree Group Leader, for the sole purpose of the assignment and to the extent of the rights which are granted to it/her/him.
 ...english version of this page |
Ce tutoriel montre comment :
Veuillez vous référer au tutoriel HT5 - Mesurer des diamètres à 1,30 m de façon automatique pour un exemple complet.
L’étape PB_StepSelectGroupsByReferenceHeight est issue du plugin base (base / Gestion des items / Sélection de groupes // hauteur de référence)
Cette étape permet de simplifier les manipulations lors de l’utilisation de l’outil interractif d’ajout d’attributs.
Il faut spéficier deux paramètres d'entrée:
Seuls les groupes présents à une hauteur de référence spécifiée sont affichés.
Ce qui a pour effet de filtrer les cylindres en trop et de n’afficher que les arbres qui possèdent un billon à 1m30.
L’étape PB_StepValidateInventory est issue du plugin base (base / Gestion des items / Sélection de groupes // Validation d’inventaire)
Cette étape permet le lancement d’un outil interactif dans lequel il est possible de sélectionner des objets et d’y ajouter des attributs descriptifs.
Il faut spéficier deux paramètres d'entrée:
Il est possible d’entrer une hauteur de référence qui servira de repère pour la présélection d’objets lors de l’ouverture de l’outil.
Une fois l’étape lancée, une fenêtre apparrait pour indiquer qu’on passe en mode manuel.
Un nouveau document 3D s’ajoute.
Les objets (ici des cylindres) non sélectionnés apparaissent en bleu, tandis que ceux sélectionnés sont en rouge. Les attributs sont affichés pour les objets en sélection active.
Pour sélectionner un nouveau cylindre, 
doit être activé. Tenez enfoncé la touche Shift puis cliquez sur le cylindre désiré.
Le bouton 
permet de retourner à la sélection initiale.
Pour entrer de nouveaux attributs, 
doit être activé.Tenez enfoncé la touche Shift puis cliquez sur le cylindre désiré. Une fenêtre permettant l’entrée s’affichera.
et afficher les points ou tout autre objets dans le Gestionnaire de modèle.
Utilisez le 
pour enregistrer les modifications et quitter le mode interractif.
L’étape PB_GroupDataExporter est issue du plugin base (base / Exporters / Attribbuts/Items d’un groupe)
Cette étape permet d’exporter en un seul fichier texte l’emsemble des attributs d’un groupe.
Sélectionnez simplement le groupe en modèle d’entrée.
Les objectifs et le fonctionnement de la plateforme sont décris dans la Charte Computree.
La plateforme Computree a été initiée au printemps 2010 dans le cadre d’une collaboration entre le département Recherche, Développement et Innovation (RDI) de l’Office National des Forêts (ONF) et l’Ecole Nationale Supérieurs des Arts et Métiers (ENSAM) de Cluny, au sein du projet ANR EMERGE.
Entre 2010 et 2015 le cœur de la plateforme a été développé et maintenu sur financements majoritairement ONF, complété par des contributions des projets ANR EMERGE et FORESEE. Les développements en eux-mêmes ont été réalisés par l’ONF (essentiellement algorithmes de traitement), et par l’ENSAM en sous-traitance (principalement cœur de la plateforme).
Initialement centrée sur le traitement des données LIDAR terrestre dans le cadre du projet ANR EMERGE, la plateforme a été généralisée aux autres sources de données telles que le LIDAR aérien à partir de fin 2014, en particulier dans le contexte du projet ANR FORESEE.
Courant 2016, l’ONF a transféré la gouvernance et la gestion de la plateforme au « Consortium Computree », piloté par le GIP-ECOFOR. Ce consortium est composé des organismes ou sociétés allouant des ressources dédiées à la plateforme dans la durée (temps de personnel, contributions matérielles ou logistiques, apport financier).
La plateforme Computree est un outil collaboratif de traitement de données dans des contextes forestiers ou de gestion des milieux naturels en général. Elle propose un environnement modulaire permettant de traiter principalement des données de télédétection : LIDAR terrestre, LIDAR aérien, photographies aériennes ou satellites, données rasters (modèles numériques de terrain, de surface ou de hauteur),… Cependant ses capacités de traitement peuvent être étendues à tout type de donnée géométrique 3D, 2D ou attributaire.
L’objectif principal de Computree est de favoriser les synergies dans le développement et l’utilisation de méthodes de traitement des données, à des fins de description, d’analyse et d’inventaires de peuplements forestiers ou autres milieux naturels. Cet objectif, se décline sous trois angles de vues complémentaires :
L’interaction entre ces trois communautés est au cœur de la philosophie de la plateforme Computree.
Les fonctionnalités de la plateforme peuvent être étendues à des usages sans rapport avec les milieux naturels, via des plugins. Cependant les ressources partagées allouées à la gestion et la maintenance de la plateforme n’interviendront pas spécifiquement dans ces domaines.
Le développement de Computree est réalisé avec la volonté de répondre aux principes suivants :La plateforme est construite selon une architecture modulaire facilitant l’ajout de fonctionnalités par des équipes indépendantes de la communauté Computree. Ainsi, elle est composée des éléments suivants :
Un plugin et plusieurs librairies de base sont fournies en standard avec la plateforme, et contiennent les fonctionnalités essentielle à la création de chaines de traitement (en particulier formats d’import / export).
Le principe de la plateforme est de proposer, par le biais des interfaces, la possibilité pour l’utilisateur de créer des séquences de traitement (workflows), à partir de briques unitaires nommées étapes contenues dans les plugins.
Chaque étape permet à partir de données d’entrée, d’appliquer un algorithme pour produire des données de sortie. Ainsi en enchaînant des étapes unitaires, potentiellement issues de différents plugins, l’utilisateur peut constituer un traitement complet adapté à ses besoins. Certaines étapes peuvent être très génériques (donc utilisables dans de nombreux contextes) ou dédiées à un usage très spécifique.
La séquence de traitement peut être intégralement constituée et sauvegardée sous forme de script, avant exécution immédiate ou décalée.
A partir de 2016, l’évolution du cœur de la plateforme Computree, de ses interfaces standard, ainsi que de certain plugins et librairies de base, est définie chaque par un comité stratégique composé des membres du Consortium Computree.
Membres actifs du consortium (2016)
| ...english version of this page |
Version pdf de cette charte : Charte_Computree_v2018_08.pdf
La présente charte définit les modalités de fonctionnement de la plateforme Computree. Elle décrit les objectifs de la plateforme, les règles de comportement, les différents rôles au sein de la communauté Computree, ainsi que les modalités de gouvernance et de gestion de la plateforme.
L’utilisation de la plateforme Computree, ou le développement de plugins et de librairies Computree implique l’acceptation expresse des conditions de la présente Charte.
Le non-respect des dispositions de la présente charte est susceptible d’entraîner l’exclusion de la Communauté Computree.
La plateforme Computree a été initiée au printemps 2010 dans le cadre d’une collaboration entre le département Recherche, Développement et Innovation (RDI) de l’Office national des forêts (ONF) et l’Ecole nationale supérieure des arts et métiers (ENSAM) de Cluny, au sein du projet ANR Emerge. Entre 2010 et 2016 le cœur de la plateforme a été développé et maintenu sur financements majoritairement ONF, complétés par des contributions des projets ANR Emerge et Foresee. Les développements en eux-mêmes ont été réalisés par l’ONF (essentiellement algorithmes de traitement), et par l’ENSAM dans le cadre de contrats de recherche (principalement cœur de la plateforme). Initialement centrée sur le traitement des données LIDAR terrestre, la plateforme a été ouverte aux autres sources de données telles que le LIDAR aérien à partir de 2014.
En 2018, s’est organisé le transfert de la gouvernance et de la gestion de la plateforme de l’ONF vers le groupement d’intérêt public Ecofor qui a constitué un groupe Computree. Ce dernier est composé des organismes ou établissements allouant des ressources dédiées à la plateforme dans la durée (temps de personnel, contributions matérielles ou logistiques, apport financier). La partie « Modalités de gouvernance, de gestion et de fonctionnement » de cette charte décrit cet aspect de façon approfondie.
Ce transfert de gouvernance est motivé par les objectifs suivants :
Les membres fondateurs du groupe Computree sont : l’Office National des Forêts, le GIP Ecofor, l’Institut National de l’Information Géographique et Forestière, l’Institut National de la Recherche Agronomique et l’Université de Sherbrooke.
La plateforme Computree est un outil collaboratif de traitement de données dans des contextes forestiers ou de gestion des milieux naturels en général. Elle propose un environnement modulaire permettant de traiter principalement des données de télédétection : LIDAR terrestre, LIDAR aérien, photographies aériennes ou satellites, données rasters (modèles numériques de terrain, de surface ou de hauteur),… Cependant ses capacités de traitement peuvent être étendues à tout type de donnée géométrique 3D, 2D, ou attributaire.
L’objectif principal de Computree est de favoriser les synergies dans le développement et l’utilisation de méthodes de traitement des données, à des fins de description, d’analyse et d’inventaire de peuplements forestiers ou autres milieux naturels. Cet objectif se décline sous trois angles de vue complémentaires :
L’interaction entre ces trois visions est au cœur de la philosophie de la plateforme Computree.
Les fonctionnalités de la plateforme peuvent être étendues à des usages sans rapport avec les milieux naturels, via des plugins. Cependant, les ressources partagées allouées à la gestion et la maintenance de la plateforme n’interviendront pas spécifiquement dans ces domaines.
La plateforme est construite selon une architecture modulaire facilitant l’ajout de fonctionnalités par des équipes indépendantes de la communauté Computree. Ainsi, elle est composée des éléments suivants :
Un plugin et plusieurs librairies de base sont fournies en standard avec la plateforme, et contiennent les fonctionnalités essentielles à la création de chaînes de traitement (en particulier formats d’import / export).
Il n’y pas de limite au nombre de plugins ou de librairies que l’on peut ajouter à Computree. De la même façon, le système est conçu pour permettre l’utilisation de nouvelles interfaces, graphiques ou non, développées par exemple pour des usages spécifiques valorisant certains plugins uniquement.
Le principe de la plateforme est de proposer, par le biais des interfaces, la possibilité pour l’utilisateur de créer des séquences de traitement (workflows), à partir de briques unitaires nommées « étapes » contenues dans les plugins. Chaque étape permet à partir de données d’entrée, d’appliquer un algorithme pour produire des données de sortie. Ainsi, en enchaînant des étapes unitaires, potentiellement issues de différents plugins, l’utilisateur peut constituer un traitement complet adapté à ses besoins. Certaines étapes peuvent être très génériques (donc utilisables dans de nombreux contextes). D’autres sont dédiées à un usage très spécifique.
La séquence de traitement peut être intégralement constituée et sauvegardée sous forme de script, avant exécution immédiate ou décalée.
On entend par « Communauté Computree » l’ensemble des personnes physiques ou morales appelées à développer ou utiliser la plateforme Computree. Afin de clarifier les interactions au sein de la communauté Computree, la présente charte définit plusieurs « rôles Computree ». Une même personne peut avoir plusieurs rôles au même moment, ou dans le temps :
Le cœur, l’interface Batch standard ainsi que les plugins communs et les librairies communes sont diffusés sous licence open-source LGPL (Lesser General Public License). L’interface graphique standard est mise à disposition sous licence GPL (General Public License).
Ces éléments peuvent ainsi être utilisés pour tout usage professionnel ou personnel, commercial ou non, respectant les conditions de la présente Charte. Comme indiqué dans les licences LGPL et GPL, la plateforme est distribuée sans aucune garantie, ni explicite ni implicite.
Chaque plugin ou librairie (en dehors des plugins communs) est la propriété d’un auteur, d’un groupe, d’un organisme, d’un établissement, d’une société ou d’un membre de la communauté Computree qui a généré ce plugin ou librairie. Le propriétaire du plugin a toute latitude pour choisir les modalités de diffusion et les conditions d’utilisation de son plugin. L’interface graphique standard de Computree étant sous licence GPL, un plugin sous licence non compatible GPL devra soit rester en usage interne, soit proposer une interface alternative. A noter que l’interface Computree Batch n’impose aucune restriction de ce type.
La plateforme accueille donc plusieurs composantes (cœur, interfaces, plugins, librairies) de différentes natures au regard des droits de propriété intellectuelle et des droits d’utilisation qui leur sont attachés.
Les éléments centraux de la plateforme font l’objet d’une propriété partagée entre les membres actuels et passés du groupe au prorata de leur contribution totale quelle que soit leur nature (montant financier, temps de personnel mis à disposition, ressources matérielles mises à disposition, évalués financièrement) cumulée depuis le 1er janvier 2010. Elles comprennent :
L’ajout de nouveaux éléments (plugins et librairies communs) à la liste des éléments centraux ne peut être fait que par le comité stratégique, dans la mesure où ces éléments sont développés sur les ressources allouées à la plateforme. Ils font l’objet d’une propriété partagée, étant précisé que chaque membre reste titulaire des droits sur ses apports initiaux (intégration de travaux antérieurs). Une liste des éléments centraux est tenue à jour par le comité stratégique et est incluse dans le rapport d’activité annuel. Est également inclus dans ce rapport d’activité un état actualisé des contributions cumulées depuis le 1er janvier 2010, de chacun de ses membres actifs ou ayant quitté le groupe. Les contributions constatées de l’année en cours sont ajoutées au bilan, après vote à l’unanimité de leur exactitude par le comité stratégique. Ce bilan donne le détail annuel des contributions et de leur nature pour chaque membre faisant ou ayant fait partie du groupe.
Quant aux autres plugins ou librairies (cas général), la propriété intellectuelle en est gérée de façon autonome : l’appartenance au groupe Computree ne donne aucun droit sur les plugins ou librairies ne faisant pas partie de la liste des éléments centraux.
Deux comités sont institués pour assurer la gestion de la Plateforme et se réunissent une fois par an chacun.
Un Comité Technique, uniquement consultatif, a pour objectif de faire des propositions d’évolution de la plateforme pour alimenter le comité stratégique. Ce comité est animé par le gestionnaire Computree et se réunit au moins une fois par an. Tous les membres du groupe Computree sont invités à participer, et il est également ouvert à tout développeur de plugin Computree. Le gestionnaire Computree fait un bilan des évolutions de la plateforme sur l’année écoulée. Il fait également une synthèse des demandes des utilisateurs obtenues par différents canaux, dont en particulier le forum utilisateur Computree. Enfin les membres du comité technique listent les propositions d’évolutions de la plateforme pour l’année à venir et proposent des critères de priorisation.
Un Comité Stratégique, composé des membres du groupe Computree tel que définis à l’article I, se réunit au moins une fois par an. Il prend toutes les décisions concernant le groupe Computree et la gestion de ses ressources. En particulier :
Seuls les membres du Groupe COMPUTREE disposent d’un droit de vote.
Le droit de vote au comité stratégique est déterminé en fonction de l’ensemble des contributions apportées par le membre (montant financier, temps de personnel mis à disposition, ressources matérielles mises à disposition évalués financièrement), pour l’année en cours. Une voix est attribuée par tranche complète de 1000 euros. Par exception, un membre ne pourra pas se voir attribuer plus de 45 % du total des droits de vote quel que soit le montant de sa contribution.
Des conventions bipartites entre le Responsable du groupe Computree et les différents partenaires, fixent le niveau prévisionnel et la durée (pour les contributions en temps de personnel) de ces contributions.
La gestion administrative du groupe Computree est assurée par le Responsable du groupe Computree. Sa mission consiste à :
Les ressources apportées par les membres du groupe (et les éventuelles participations aux frais de séminaires demandées aux participants, décrites à l’article III.5) sont utilisées pour la maintenance et les évolutions des éléments centraux de Computree, les tests ainsi que pour l’animation de la communauté Computree, la diffusion et la documentation de la plateforme.
A noter que le développement des plugins et librairies n’est pas financé sur les ressources allouées à la plateforme, à l’exception des plugins et librairies inscrits à la liste des éléments centraux, dont le développement aura été validé par le comité stratégique et la liste tenue à jour par le gestionnaire Computree.
L’utilisation de Computree et les ressources mises à disposition pour permettre et faciliter le développement de plugins sont entièrement gratuits. Des ressources en ligne sont mises à disposition pour faciliter l’autonomie des membres de la communauté Computree. Un forum d’échange vise également à favoriser l’entraide au sein de la communauté.
Des séminaires « développeurs de plugins » sont proposés en fonction des besoins. Ils sont gratuits pour tout plugin diffusé sous licence Open-Source et restant dans les champs d’application des milieux naturels ou de la forêt. Dans tous les autres cas, ils font l’objet d’un paiement sur facture de frais de séminaires.
Chaque année, au moins un séminaire « utilisateurs Computree » est proposé à la communauté, éventuellement plusieurs selon la demande et les besoins. Ces séminaires ont pour objet d’initier les utilisateurs à l’utilisation de la plateforme Computree. Des séminaires d’approfondissement thématiques pourront également être proposés. Ces séminaires pourront faire l’objet d’un paiement sur facture de frais de séminaires occasionnés par chaque stagiaire. Afin d’en faciliter l’accès, des séminaires « utilisateurs Computree » peuvent également être proposés au catalogue de formation d’un ou plusieurs organismes membres du groupe.
Les ressources éventuellement issues de l’organisation de ces séminaires viennent abonder le budget permettant l’évolution de la plateforme. Par ailleurs, les membres de la communauté Computree ont toute liberté pour organiser leurs propres séminaires ou formations Computree.
Lorsqu’un nouveau membre souhaite intégrer le groupe Computree, un projet de convention avec le Responsable du groupe Computree – spécifiant s’il y a lieu les contributions passées aux éléments centraux de la plateforme, et dans tous les cas les contributions prévues pendant la période de la convention – est rédigé en amont de la réunion du comité stratégique. Au cours de la réunion, le comité stratégique examine et statue sur l’intégration du nouveau membre à la majorité des deux tiers. Une fois l’intégration validée et la convention entre le nouveau membre et le Responsable du groupe Computree signée par les deux parties, le nouveau membre intègre le groupe Computree et siège au comité stratégique.
Les nouveaux membres s’engagent à respecter les obligations qui leur incombent et les dispositions de la présente charte.
Les nouveaux membres s’engagent à allouer des ressources significatives (de valeur équivalente supérieure ou égale à 5 000 €/ an), sur la durée, pour maintenir ou développer les éléments centraux de la plateforme Computree. Ces ressources sont définies dans le cadre d’une convention pluriannuelle avec le Responsable du groupe Computree. Elles peuvent être de différentes natures :
Dans tous les cas, ces ressources sont converties en un montant monétaire équivalent, afin de déterminer les droits de vote de chaque membre du groupe, au prorata de sa contribution pour l’année en cours.
Dans le cas où l’un des membres manquerait aux obligations prévues dans la présente charte, et après une mise en demeure du Responsable du groupe Computree restée sans effet pendant un délai de trois mois, le Comité stratégique peut décider de son éviction (par vote à l’unanimité, le membre concerné n’étant pas pris en compte dans le vote), étant précisé que les contributions versées ne lui sont pas restituées.
Dans ce cas le Comité Stratégique mandate le Responsable du groupe Computree pour résilier la convention avec le membre concerné. La date de résiliation sera fixée autant que possible en fin d’exercice annuel.
Lors de l’arrivée à échéance de la convention de l’un des membres du groupe, ce membre peut de plein droit décider de son renouvellement (par avenant ou nouvelle convention), sauf s’il a eu un comportement en violation avec les dispositions de la présente charte.
Cependant, en cas d’augmentation de la contribution de plus de 50 %, le comité stratégique doit donner son accord pour cette augmentation par un vote à la majorité absolue, le membre concerné n’étant pas pris en compte dans le vote.
Les droits de vote seront recalculés selon les modalités définies à l’article III.2.
La plateforme Computree est mise à disposition « en l’état », sans garantie d’aucune sorte, explicite ou implicite, y compris, mais sans limitation, les garanties implicites de qualité marchande et d’adaptation à un usage en particulier. L’intégralité du risque de qualité et de performance de la plateforme est supportée par l’utilisateur. Si la plateforme est défectueuse, l’utilisateur assume seul le coût de toute réparation nécessaire.
Ainsi les membres du Groupe Computree ne sont pas responsables de l’utilisation faite par les utilisateurs de la Plateforme ou des résultats des analyses en découlant.
Aucune stipulation de la présente Charte ne pourra être interprétée comme constituant entre les les membres une entité juridique de quelque nature que ce soit, ni impliquant une quelconque solidarité entre les membres.
Les membres déclarent que la présente Charte ne peut en aucun cas être interprétée ou considérée comme constituant un acte de société, l’affectio societatis est formellement exclu.
Aucun membre n’a le pouvoir d’engager les autres membres, ni de créer des obligations à la charge des autres membres, en dehors du Responsable du groupe Computree dans le seul cadre de la mission qui lui est confiée et dans la limite des droits qui lui sont conférés.
| ...english version of this page |
| Retour à la liste des How Tos |
| ...english version of this page |
Le Mode Batch est un gestionnaire d’interfaces alternatives à l’interface graphique standard, dédié à des traitements plus automatisés et répétitifs.
Lorsqu’on exécute le Mode Batch, cela ajoute une icône à la barre de tâche : 
. Un clic-droit sur cette icône donne la possibilité d’exécuter une interface batch.
Chaque interface batch contient des fonctionnalités dédiées à des traitements spécifiques.
Il est possible de lancer un script en ligne de commande et d’attendre l’exécution de celui-ci. Le programme se ferme automatiquement lorsque la fin des traitements sont terminés. Plus d’info en tapant dans une console ms-dos la commande ComputreeBatch.exe --help.
| Page précédente (Plugins disponibles) | Retour au sommaire |
| ...english version of this page |
Les sections suivantes présentent les fonctionnalités de l’interface.
Vous trouverez ici un TP d’application sur l’utilisation de l’interface ComputreeGUI
| Page précédente (Types d’items) | Retour au sommaire | Page suivante (Plugins disponibles) |
| ...english version of this page |
Jusqu’à présent nous avons vu comment créer un arbre d’étapes, l’exécuter et visualiser ses résultats.
L’objectif de Computree est de traiter les nuages de points à l’aide d’algorithmes automatiques contenus dans les étapes.
Cependant, il est parfois nécessaire d’intervenir manuellement sur les résultats. C’est pour cela que Computree propose le concept d’ action.
Une action est un outils, utilisant les vues d’une certaine façon pour interroger et / ou modifier un résultat contenant certains types d’items.
Les actions, implémentées dans les plugins, peuvent être utilisées selon deux méthodes (une même action peut parfois être utilisable dans les deux modes) :
Le mode interactif est géré par le gestionnaire d’actions (Actions). Y sont listées toutes les actions disponibles pour la vue active.
Il suffit de cocher l’action souhaitée. Une seule action peut être utilisé à la fois.
Gestionnaire d’actions :
Les actions y sont classées par types. Quand on en coche une, elle devient active, et toutes les autres deviennent inactives.
En mode étapes, les actions ne sont pas visibles par l’utilisateur, car c’est une étape qui y fait appel lors de son exécution.
Dans ce cas, lorsque l’étape est exécutée, à un moment donné elle s’interrompt, et donne la main à l’utilisateur. L’icone 
devient active (en couleur).
En général un message prévient l’utilisateur qu’il doit intervenir. La plupart du temps, l’action ouvre une vue spécifique, en fournissant une barre d’outils adaptée à sa fonction.
Une fois que l’utilisateur à réalisé l’opération nécessaire, il lui suffit de cliquer sur , pour lancer la suite de l’exécution, sur la base du travail interactif réalisé.
Il est possible d’ajouter des items à l’aide du gestionnaire de modèle ou du gestionnaire d’items dans la vue créée par l’action, conjointement avec les tracés réalisés par l’action elle-même.
[[plugin-base:Fr_wiki#Actions fournies par le plugin|Se rendre sur la page Wiki du Plugin Base]]
| Page précédente (Fonctionnement des vues) | Retour au sommaire GUI | Page suivante (Utilisation des exporters) |
| ...english version of this page |
Les exporters permettent, comme leur nom l’indique, d’ exporter des items dans des fichiers.
Comme pour les actions, les exporters implémentées dans les plugins, peuvent être utilisées selon deux méthodes :
Pour utiliser le mode interactif, il faut commencer par sélectionner des items dans une vue.
Ensuite il faut cliquer sur le bouton 
de la barre d’outils de la vue, et sélectionner l’exporter à utiliser.
Pour utiliser le mode étape, il faut ajouter l’étape d’exporter souhaitée (à l’aide du gestionnaire d’étapes) après l’étape dont on veut exporter des items.
Ainsi dans le gestionnaire d’étapes, il faut faire un clic droit sur l’étape à exporter, choisir dans le sous-menu de plugin adéquat, la catégorie exporter, puis l’exporter souhaité.
Par exemple pour les exporters du plugin Base :
Ensuite une fenêtre de configuration des résultats d’entrée apparaît, afin de sélectionner les items que l’on veut confier à l’exporter.
[[plugin-base:Fr_wiki#Exporters fournis par le plugin|Se rendre sur la page Wiki du Plugin Base]]
L’icone 
permet d’accéder aux options générales de la barre d’outils principale. A ce jour il n’y a qu’une options disponible : le choix du séparateur décimal (pour les imports / exports en format texte) :
| Page précédente (Utilisation des actions) | Retour au sommaire GUI |
| ...english version of this page |
ComputreeGUI est l’interface graphique standard pour Computree. Elle permet la gestion des étapes et de leurs résultats, ainsi que leur affichage paramétrable dans des vues 3D ou tabulaires.
La barre d’outils principale (2) reprend sous forme d’icône la plupart des fonctionnalités présentes dans les menus (1). Ces fonctionnalités seront décrites dans les différentes parties de cette documentation.
Le gestionnaire d’étape (3) est l’élément central car il permet de créer et d’exécuter l’arbre des étapes. Il sera décris en détails dans Gestion des traitements, ainsi que la fenêtre de log (10).
Le gestionnaire de modèles (4) et le configurateur d’items (5) permettent de gérer l’ Affichage des items.
Les vues, 3D (6) et tabulaires (7), ainsi que le gestionnaire de synchronisation des vues (9) seront décris dans le Fonctionnement des vues.
Le gestionnaire d’actions (8) sera présenté dans le cadre de l’ Utilisation des actions.
Les éléments 3 à 5 et 8 à 10 sont des composants dockables, qui peuvent être déplacés, superposés (avec des onglets) ou utilisés en fenêtres volantes. Pour cela il suffit de faire un clic-gauche sur leur barre de titre et de les déplacer, en maintenant le clic, vers leur destination souhaitée. Le menu fenêtre fournit 3 options d'organisation par défaut de ces composants :
On peut personnaliser l’organisation des composants, en les déplaçant.
L’agencement des composants est sauvegardé dans le fichier config.ini à la fermeture, et est donc rechargée à la session suivante de Computree.
Si un composant a été fermé, il peut être rappelé à l’aide du menu fenêtre.
La fenêtre A propos des plugins, liste les plugins chargé. Pour chacun, les étapes disponibles. Pour chaque, étape les modèles IN et OUT.
Le bouton Recharger permet de relancer le chargement des librairies de plugins, et en particulier de changer le chemin d’accès au répertoire de plugins dans le cas où il ne serait pas à l’emplacement par défaut.
Si on clique sur une étape, puis sur le bouton Info Etape, on obtient une fenêtre donnant les informations suivantes pour l'étape :
| Retour au sommaire GUI | Page suivante (Gestion des traitements) |
| ...english version of this page |
Le gestionnaire de modèles (ModelManager) permet de visualiser le modèle OUT d’un résultat. Quand on clique sur la case à cocher d’un résultat dans le gestionnaire d’étapes (StepManager), son modèle devient actif dans le ModelManager.
Cependant la combo-box située en haut du gestionnaire de modèles (ModelManager) permet de choisir parmi les résultats affichés, celui dont on veut visualiser le modèle. Dans la combo-box, pour chaque résultat, figure entre parenthèses le nom et le numéro de l’étape mère, afin de pouvoir se repérer dans le gestionnaire d’étapes (StepManager).
Dans le gestionnaire de modèles (ModelManager), le premier niveau donne le nom du résultat.
Ce niveau porte ensuite la hiérarchie niveaux correspondants à des groupes et à des items, chacun disposant d’une case à cocher. Ces cases permettent de régir l’affichage des éléments d’intérêt dans la vue active.
Dans le gestionnaire de modèles (ModelManager), il y a une colonne par vue de la zone des vues. Le numéro de la colonne correspond au numéro de la vue.
Les niveaux de groupes se reconnaissent à la petite flèche avant leur nom, qui permet de masquer / afficher les éléments fils. Les niveaux d’item ne pouvant pas avoir d’éléments fils, ils ne disposent pas de cette flèche.
Quand on coche un niveau de groupe, celui-ci ne contenant pas de donnée à proprement parler, cela déclenche l’affichage de ses éléments fils récursivement.
En faisant un clic droit sur un niveau de la hiérarchie des modèles, on obtient un menu contextuel permettant de gérer les options de colorisation des éléments affichés :
L’ItemConfigurator permet de régler des options affichages des items présents dans au moins une vue.
En haut, une combo-box, liste toutes les classes d'items actuellement affichés dans au moins une des vues. Elle permet de sélectionner la classe d'item pour laquelle on veut régler les options d'affichage. Ces options (caractéristiques modifiables) sont présentées ensuite sur deux colonnes :
Dans le cas général, les options sont gérées de façon homogène pour toutes les instances d’une même classe d’item.
Cependant pour certaines classes d’items (les grilles 2D ou 3D par exemple), les paramètres peuvent être fixés pour chaque instance spécifiquement. Dans ce cas la même classe apparaît une fois par instance dans la combo-box, identifiée par l’identifiant de l’item.
| Page précédente (Gestion des traitements) | Retour au sommaire GUI | Page suivante (Fonctionnement des vues) |
| ...english version of this page |
L’ arbre des étapes est géré dans le gestionnaire d’étapes (StepManager). Ce composant permet de créer une hiérarchie d’étapes compatibles entre-elles. Une fois les traitements exécutés, chaque étapes porte les résultats qu’elle a créé.
Gestionnaire d’étape après création d’un arbre d’étapes, mais avant exécution :
Gestionnaire d’étape pendant l’exécution de l’ arbre des étapes :
Gestionnaire d’étape après la fin de l’exécution :
La première colonne contient le nom des étapes, avec des flèches à gauche permettant de replier la hiérarchie affiliée à chaque étape.
Une fois l’exécution réalisée elle contient également le nom des résultats produits.
La seconde colonne contient une barre de progression, permettant de suivre l’avancée de l’exécution.
La troisième colonne stocke le temps d’exécution des étapes (mis à jour en même temps que le pourcentage de progression).
Dans le cas des résultats, cette colonne contient une case à cocher. Cocher cette case, permet “d’envoyer” le résultat au gestionnaire de modèle (ModelManager). Cela a pour effet d’afficher le modèle de résultat OUT de l’étape dans le gestionnaire de modèle (ce qui permettra de gérer son affichage, comme nous le verrons dans la section Affichage des items).
La quatrième colonne, permet pour les étapes d’activer le mode débug.
Pour lancer l’exécution de l’arbre des étapes il faut cliquer sur le bouton 
. On peut également interrompre l’exécution à l’aide du bouton 
.
Pour exporter l’arbre des étapes en tant que fichier script, il faut cliquer sur le bouton 
. Les scripts peuvent ensuite être chargés à l’aide du bouton 
.
Pour initier une séquence d’étapes, il faut commencer par insérer une étape initiale.
On peut insérer :
. Dans ce cas, une fenêtre de choix de fichier s’ouvre, et le chargement des données s’exécute, une fois le choix de fichier validé. 
. Dans ce cas il faut sélectionner l’étape dans le sous-menu du plugin qui la contient. Ce type d’étape permet de faire des chargements plus complexes (plusieurs fichiers de types différents, paramétrages avant chargement...).
Une fois un point de départ inséré, l’ajout d’autres étapes se fait à l’aide du menu contextuel : clic-droit sur une étape à laquelle on veut ajouter une étape fille.
Éléments du menu contextuel d’étapes :
La première partie du menu permet de modifier l’étape en cours :
La seconde partie du menu contient un sous menu pour chaque plugin d’étape chargé. Ce sous menu contient la liste des étapes du plugin. Celles en grisé ne sont pas compatibles avec les résultats produits par l’étape en cours. Les autres peuvent être ajoutées. En laissant la souris un instant immobile, on obtient une info-bulle décrivant sommairement la fonction de l’étape. En cliquant l’étape est ajoutée, ce qui provoque l’affichage de la fenêtre de configuration des résultats d’entrée (si nécessaire), puis de la fenêtre de paramétrage de la nouvelle étape fille.
Une fois ajoutée, l’étape doit (la plupart du temps) être configurée.
Tout d’abord l’étape analyse les résultats de l’étape mère (voire de toute la hiérarchie en amont si la recherche récursive est active pour le résultat considéré). Cette analyse sélectionne le(s) résultat(s) compatible(s) en entrée.
Cette sélection fonctionne par comparaison entre le modèle de résultats IN de l’étape ajoutée, avec les modèles de résultats OUT des résultats candidats.
Dans le cas où plusieurs résultats sont valides, la fenêtre de configurer les résultats d’entrée est ouverte :
La partie gauche liste les résultats candidats, classés par élément recherché du modèle de résultat IN de l’étape. Le numéro de l’étape portant chaque résultat est indiqué entre parenthèses.
En double-cliquant sur un résultat de gauche, cela le transfert en tant que correspondance validée dans la partie droite (on peut aussi le glisser de la partie gauche vers la partie droite).
La partie droite affiche les correspondances de résultats validées, en haut. En bas elle permet de sélectionner, si nécessaire, au sein d’un résultat donné les niveaux de groupes et d’items à utiliser.
Explication du concept de tours
Une fois tous les choix effectués, il suffit de cliquer sur OK, pour valider la configuration des résultats d’entrée.
Ensuite, s’il y a lieu, la fenêtre de paramétrage de l’étape s’ouvre. Elle contient tous les paramètres réglables de l’algorithme à exécuter. Exemple pour l’étape OE_StepExtractSoil03 :
Une fois les paramètres choisis et validés, l’étape est effectivement ajoutée dans l’ arbre des étapes.
| Page précédente (Organisation générale de l’interface) | Retour au sommaire GUI | Page suivante (Affichage des items) |
| ...english version of this page |
On peut ajouter une nouvelle vue 3D en cliquant sur le bouton 
de la barre d’outils principale.
La vue 3D est la plus utilisée dans ComputreeGUI, car c’est elle qui permet de visualiser les items créés par les étapes en trois dimensions. Elle utilise OpenGL, en valorisant un composant graphique QGLViewer (http://www.libqglviewer.com/). La navigation 3D se fait de la façon suivante :
La barre d’outils permet d’accéder à des fonctionnalités supplémentaires.
Le bouton 
permet de gérer les points de vues (paramètres de caméra). Détails sur les points de vues
Le bouton 
donne accès aux exporters pour les items sélectionnés. Cette fonctionnalité est décrite dans la section Utilisation des exporters.
Le bouton 
permet de régler les préférences pour la vue. Détails sur les préférences pour la vue
Le bouton 
permet d’appliquer une coloration aux points / faces / demi-arêtes en fonctions d’attributs. Détails sur la coloration des points
/ 
/ 
permet de régler l’optimisation graphique (comme dans la boite de dialog obtenue avec ) :
: réduction du nombre de points lors des déplacements : réduction du nombre de points tout le temps : affichage de tous les points même lors des déplacementsLa séquence de boutons 
/ 
/ 
permet de régler la taille des points (1 / 2 / 3 pixels).
Le bouton 
permet de lancer le calcul d’un octree. Cette structure accélératrice permet des sélection beaucoup plus rapides (en particulier lors de la sélection de points).
Le bouton 
permet d’ouvrir un sous menu contenant les icônes suivantes : 
. Chacune permet d’orienter la caméra selon le point de vue sélectionné.
Le bouton 
permet d’ajuster l’emprise de la vue sur la boite englobante des éléments affichés. Cela permet au passage de définir l’extension de la zone affichée pour la caméra, ce qui recalcule les plans de clipping avant et arrière (rien n’est dessiné en avant / au delà de ces plans). Ce bouton ne fonctionne qu’avec des items dont la boite englobante est correctement définie (c’est toujours le cas des items contenant des points).
Le bouton 
permet définir le centre de rotation de la caméra sur le centre de l’item / du point sélectionné.
Le bouton 
permet définir le centre de rotation de la caméra sur le centre de la boite englobante de l’ensemble des éléments affichés.
Le bouton 
permet définir le centre de rotation de la caméra sur (0,0,0)
Le bouton 
permet de régler manuellement tous les paramètres de la caméra. Détails sur le réglage de la caméra
Il est possible de synchroniser les caméras de plusieurs vues 3D : ainsi quand on change une des vues, les autres vues synchronisée s’ajustent pour donner le même point de vue.
Pour cela il suffit d’activer le bouton Sync de la barre d’outils de chaque vues que l’on veut synchroniser. Le bouton est alors modifié en Sync.
On peut ajouter une nouvelle vue 2D en cliquant sur le bouton 
de la barre d’outils principale.
Une vue 2D fonctionne exactement comme une vue 3D, mais la caméra est verrouillée sur un point de vue depuis le haut.
De plus sa projection est orthoscopique, ce qui fait qu’il n’y a pas d’effet de perspective.
On peut ajouter une nouvelle vue tabulaire en cliquant sur le bouton 
de la barre d’outils principale.
Une vue tabulaire permet d’afficher des informations attributaires sur les items qu’elle contient. Des items de classes différentes peuvent se côtoyer dans une même vue tabulaire. Pour cette raison les colonnes ne contiennent pas le nom des champs.
Chaque ligne affiche les données d’un item, avec un champ par colonne. Dans chaque case le format standard d’affichage est le suivant : code variable : valeur de la variable.
Dans tous les cas la colonne 1 contient l’identifiant unique de l’item, et la colonne 2 le nom de sa classe.
Dans le cas général on ajoute des items à une vue tabulaire de la même façon qu'à une vue 3D :
Une vue tabulaire peut également fonctionner en mode synchronisation. Dans ce cas on synchronise la vue tabulaire avec un ou plusieurs vues 3D (ou autres). Ensuite tout item sélectionné dans une des vues est automatiquement ajouté également à la vue tabulaire (si un item est désélectionné il est supprimé de la vue tabulaire également).
Pour synchroniser des vues avec la vue tabulaire, il faut cliquer sur le bouton Sync with..., et ensuite cocher les vues que l’on souhaite synchroniser.
Il est possible de supprimer le contenu de toutes les vues en cliquant sur le bouton 
.
Le menu Vue permet de réorganiser les vues dans la zone de vue :
| Page précédente (Affichage des items) | Retour au sommaire GUI | Page suivante (Utilisation des actions) |
| ...english version of this page |
| Page précédente (Interface graphique standard) | Retour au sommaire | Page suivante (Mode batch) |
| ...english version of this page |
| Retour à la liste des How Tos |
| ...english version of this page |
Computree comporte des items de différentes natures, afin de gérer les différents types de données nécessaires aux algorithmes développés. Un certain nombre de types d’items standards sont proposés dans le coeur, ce qui permet de rendre compatibles les plugins entre eux.
Computree est conçu pour gérer des nuages de points 3D. A ce titre les points ont une place spécifique dans la plateforme. Ainsi les points (classe d’item : CT_Point) ne sont pas des items, afin d’optimiser la gestion de la mémoire.
Un point est simplement un tableau de trois nombres décimaux (de type float, à 7 chiffres significatifs) contenant ses coordonnées (x,y,z). Tous les points créés dans une session sont regroupés dans un dépôt de points, et indexés de façon continue.
Il est prévu à court terme d’intégrer un système de changement de repère à l’importation pour éviter ce problème. Cela sera en particulier nécessaire pour l’utilisation de données LiDAR aériennes.
Afin de pouvoir gérer / afficher les points, ceux-ci sont gérés à l’aide d’items “contenant des points”, et donc héritant de la classe d’item : CT_AbstractItemDrawableWithPointCloud.
Il existe deux types d'items de ce genre à ce jour :
Sur le même modèle que les points, Computree peut gérer des maillages. Ainsi un maillage est contitué de points, de faces et de demi-arêtes. Chacun de ces éléments est géré similairement au points (ce ne sont pas des items). Il y a donc un dépôt de faces et un dépôt de demi-arêtes.
Comme pour les points, il existe un type d’item gérant l’agencement des points, faces et demi-arêtes : les modèle de mesh (classe d’item : CT_MeshModel). C’est lui qui va gérer la construction, la modification et l’affichage des éléments unitaires du maillage.
Nous avons vu les items permettant de stocker les informations 3D pour les points, les faces et les demi-arêtes. Cependant, on utilise fréquemment des données associées à ces éléments, tels qu’une intensité, une couleur ou une normale.
Il existe donc des types d’items chargés de stocker ces informations liés aux éléments unitaires cités : les attributs.
Il existe un type d’item pour chaque croisement attribut (nature de donnée) / type d’élément.
A ce jour, Computree gère les attributs suivants :
Computree propose une série de types d’items pour gérer les formes géométriques 3D, sur une logique commune.
Ainsi il existe un type d’item pour chaque forme géométrique, héritant tous de la classe d’item CT_AbstractShape :
Il est prévu à moyen terme d’ajouter d’autres formes géométriques : polygones 3D, rectangle, parallélépipède, cône,courbes de bézier,...
Ces classes d’items sont des templates, c’est à dire qu’on peut les décliner pour différents types de données dans les cases.
Ces structures fonctionnent de façon très semblables. Elle gèrent les valeurs manquantes (sauf dans le cas de grilles booléennes).
Il existes d'autres types d'items plus spécifiques à certains usages :
| Page précédente (Présentation générale) | Retour au sommaire | Page suivante (Interface graphique standard) |
| ...english version of this page |
Ce tutoriel montre comment :
Veuillez vous référer au tutoriel HT1 - Charger, visualiser, découper et exporter un nuage de points T-Lidar à la section Chargement d’un nuage de points.
Veuillez vous référer au tutoriel HT1 - Charger, visualiser, découper et exporter un nuage de points T-Lidar à la section Extraction d’un sous-nuage.
L’étape PB_StepReducePointsDensity1 est issue du plugin base (base / Nuages de points / Réduction de la densité de points)
Si vous utilisez des scans multiples, il est recommendé d’ajouter une étape permettant de réduire la densité de points afin de réduire les temps de calcul. Selon la puissance de votre ordinateur, une Résolution de 0.5 ou 1 cm devrait est être suffisante.
Veuillez vous référer au tutoriel HT2 - Créer un Modèle Numérique de Terrain à partir d’un nuage de points T-Lidar.
L’étape OE_StepHorizontalClustering04 est issue du plugin onfensamv2 (onfensamv2 / Clustering / tranches horizontales)
Cette étape permet d’aggréger les points en petits groupes (clusters). La scène est d’abord découpée en tranches horizontales de l’ Épaisseur choisie. Puis, pour chacune des tranches, les points sont aggrégés selon leur espacement en (X,Y). La Distance maximale séparant deux points d’un même groupe est spécifiée en paramètre.
Résultat de l’étape de création des clusters:
L’étape OE_StepFilterClustersBySize est issue du plugin onfensamv2 (onfensamv2 / Filtrage de clusters / nb. de points)
Cette étape filtre les clusters selon un Nombre de points minimum par groupe. Si le nombre de points contenu dans un cluster est inférieur à cette valeur, le cluster sera éliminé.
L’étape OE_StepDetectSection07 est issue du plugin onfensamv2 (onfensamv2 / Aggrégation verticale de clusters en billon)
Cette étape effectue une aggrégation verticale des groupes de points en billons. Un Seuil de distance vertical est utilisé pour la comparaison des groupes de points en pair. S’il y a intersection verticale des boîtes englobantes des clusters sur cette distance, ceux-ci seront aggrégés. Il y a arrêt d’aggrégation lors d’une rupture verticale au niveau du nuage de points. La présence d’occlusions ou d’une branche sont des causes communes.
Résultat de l’étape d’aggrégation:
L’étape OE_StepFilterGroupsByGroupsNumber est issue du plugin onfensamv2 (onfensamv2 / Filtrage de groupes niv.1 / nb. de groupes niv.2)
Cette étape générique permet de retirer les groupes (ici les billons) possédant un nombre insuffisant de sous-groupes (ici les clusters). Les groupes de niveau 1 (billons) sont éliminés s’ils possèdent un nombre inférieur au Nombre minimal de groupe de niveau 2 requis. Cette étape permet de retirer la plupart des petites branches et faux billons.
Résultat de l’étape de filtrage des billons:
L’étape OE_StepMergeNeighbourSections04 est issue du plugin onfensamv2 (onfensamv2 / Fusion de billons parallèles)
Cette étape permet de fusionner les billons parallèles. Dans le cas d’occlusion par exemple, certaines branches peuvent être coupées, ce qui peut créer deux billons côte à côte qui devraient ne faire qu’un:
L’étape OE_StepMergeEndToEndSections04 est issue du plugin onfensamv2 (onfensamv2 / Fusion de billons alignés)
Cette étape permet de fusionner les billons alignés en direction. L'étape fonctionne de la manière suivante (voir également le schéma explicatif ci-bas):
Schéma explicatif:
Résultat de la fusion:
L’étape OE_StepSetFootCoordinatesVertically est issue du plugin onfensamv2 (onfensamv2 / Ajout d’une coordonnée de base / billon // MNT)
Aucun paramètre n’est requis. Cette étape permet d’associer une position aux billons en projetant le cluster le plus bas sur le MNT.
L’étape OE_StepFitAndFilterCylindersInSections est issue du plugin onfensamv2 (onfensamv2 / Ajustement/Filtrage des cylindres / billon)
Cette étape effectue l’ajustement de cylindres sur les billons ainsi qu’une filtration de ceux-ci selon la qualité de l’ajustement. Les Rayon minimum et Rayon maximum sont spécifiés afin de limiter l’ajustement de cylindres sur des arbres trop petits ou trop grands. La qualité de l’ajustement est ensuite évaluée selon l’*Erreur absolue* et/ou l’*Erreur relative*. On peut également filtrer les cyclindres selon la verticalité de ceux-ci, un Angle maximal depuis le zénith est alors spécifié.
Résultat de l’ajustement de cylindres:
L’étape OE_StepExtractDiametersFromCylinders est issue du plugin onfensamv2 (onfensamv2 / Calcul d’un diamètre moyen des cylindres / billon)
Cette étape permet de calculer le diamètre à hauteur de poitrine (DHP) des arbres. Pour ce faire, un cercle est ajusté sur un cylindre précédemment créé. Une Hauteur minimale ainsi qu’une Hauteur maximale d’évaluation sont spécfiées. Les rayons des cercles sont calculés entre ces deux valeurs pour calculer une regression. La valeur à Hauteur de référence (généralement 1.30 mètres) est alors interpolée ce cette regression. La Décroissance métrique maximale permet de s’assurer qu’aucun cylindre aberrant ne sera utilisé dans le calcul. Un Nombre de cylindres minimum pour ajuster un cercle est également spécifié.
Pour afficher les cercles ajustés à l’écran, il suffit d’activer les résultats dans les gestionnaires d’étape et de modèle.
Pour afficher à l’écran les attributs, activez 
Information ItemDrawable dans l’onglet Action et cliquez sur l’objet désiré.
L’étape PB_CSVExporter est issue du plugin base (base / Exporters / Export d’attributs (csv))
Sélectionnez d’abord le modèle d’entrée.
Glissez ensuite les attributs désirés dans la fenêtre de droite.
Spécifiez finalement l’emplacement et le nom du fichier csv.
1 Plugin Base.
_
| Retour à la liste des How Tos |
| ...english version of this page |
| Retour à la liste des How Tos |
| ...english version of this page |
Apprendre à utiliser Computree
Vidéo : https://www.youtube.com/watch?v=0rgvP8XvhnU
Tutoriel pdf détaillé : Tutorial_01_FR.pdf
Dans une invite de commande taper :
CompuTreeBatch -script "script_name.xsct2" -startSteps
| ...english version of this page |
Apprendre à utiliser Computree
Dans une invite de commande taper :
CompuTreeBatch "script_name.xsct2"
attachment:Tutorial_DATA01...
attachment:Tutorial_TLS01...
attachment:Tutorial_TLS02...
attachment:Tutorial_TLS03...
| ...english version of this page |
Ce tutoriel montre comment:
Veuillez vous référer au turoriel HT1 - Charger, visualiser, découper et exporter un nuage de points T-Lidar.
Pour ajouter une étape, il suffit de faire un clic droit sur l’étape précédente. Sélectionnez ensuite le plugin onfensamv2, puis l’étape Séparation sol / végétation → MNT.
Exemple d’un modèle numérique de terrain (MNT):
Veuillez-vous référer au turoriel HT1 - Charger, visualiser, découper et exporter un nuage de points T-Lidar.
| Retour à la liste des How Tos |
| ...english version of this page |
Pour installer Computree, commencez par télécharger l’archive de la version correspondant à votre système dans la section Documents :
Décompressez l’archive à l’endroit où vous souhaitez installer Computree.
Sous Windows, il suffit de créer un raccourci (clic droit, créer un raccourci) vers le fichier exécutable CompuTreeGui.exe.
Sous Ubuntu, la création du raccourci nécessite quelques étapes supplémentaires (version 13.04 et ultérieures d’Ubuntu).
sh createlauncher.sh
Sinon il est toujours possible de lancer directement Computree depuis un terminal, en tapant dans le répertoire d’installation de Computree, la commande suivante :
sh CompuTreeGui.sh
| Retour à l’accueil |
| ...english version of this page |
Vous pouvez télécharger Computree :
Une fois téléchargée, décompressez l’archive à l’endroit où vous souhaitez installer Computree.
Sous Windows, il suffit de créer un raccourci (clic droit, créer un raccourci) vers le fichier exécutable CompuTreeGui.exe.
Sous Ubuntu, la création du raccourci nécessite quelques étapes supplémentaires (version 13.04 et ultérieures d’Ubuntu).
sh createlauncher.sh
Sinon il est toujours possible de lancer directement Computree depuis un terminal, en tapant dans le répertoire d’installation de Computree, la commande suivante :
sh CompuTreeGui.sh
| ...english version of this page |
Vous pouvez télécharger Computree pour Windows 7/8/10 64 bit
Une fois téléchargée, décompressez l’archive à l’endroit où vous souhaitez installer Computree.
Pour Linux, il faut compiler Computree à partir des codes sources, comme indiqué ici
Sous Windows, il suffit de créer un raccourci (clic droit, créer un raccourci) vers le fichier exécutable CompuTreeGui.exe.
Problème connu : Computree ne semble pas fonctionner avec les cartes graphiques Intel HD.
Sous Ubuntu, la création du raccourci nécessite quelques étapes supplémentaires (version 13.04 et ultérieures d’Ubuntu).
sh createlauncher.sh
Sinon il est toujours possible de lancer directement Computree depuis un terminal, en tapant dans le répertoire d’installation de Computree, la commande suivante :
sh CompuTreeGui.sh
| ...english version of this page |
Cette section présente la philosophie et les concepts importants de Computree.
Le but de Computree est de permettre le traitement de nuages de points 3D, pour en extraire des informations utiles, comme par exemple :
La plateforme se place dans une logique de Recherche et Développement. L’idée est donc de permettre à l’utilisateur de créer de façon intéractive une séquence algorithmique permettant, à partir de données chargées, d’aboutir aux résultats souhaités. Cette séquence - plutôt un arbre hiérarchique en fait, car il est possible de ramifier cette séquence en chaînes algorithmiques parallèles - est décomposée en étapes algorithmiques unitaires, réalisant des traitements spécifiques.
Les étapes sont regroupées dans des plugins, ce qui permet d’enrichir facilement la plateforme avec de nouveaux traitements.
Après l’exécution de la séquence algorithmique, les résultats intermédiaires de chaque étape unitaire sont disponibles, exportables et visualisables, ce qui permet une analyse poussée de la qualité des traitements effectués.
La plateforme a été développée avec la philosophie suivante :
L’objectif est ainsi de permettre à différentes équipes de collaborer autour du traitement de scène 3D forestières.
Mais si la plateforme permet une logique collaborative de R&D, elle est également prévue pour permettre un passage facile des méthodes développées dans un environnement de production (en gestion forestière par exemple). En effet, le système rend aisée la création d’interfaces adaptées à des besoins spécifiques, en utilisant le cœur et les plugins de façon transparente.
La plateforme Computree est composée des éléments suivants :
Pour traiter les données, Computree utilise un arbre d’étapes, exportable en tant que script (extension .xsct2). La racine de l’arbre est une étape de chargement ou de création de données. Ensuite chaque étape est attachée à une étape mère. L’arbre des étapes peut être intégralement constitué avant d’exécuter les calculs.
Les étapes sont implémentées dans les plugins (indépendants). Chaque étape prend en entrée des résultats issus de l’étape précédente, et produit d’autres résultats en sortie.
Les résultats contiennent les données en elles-mêmes. Pour permettre l’enchaînement d’étapes développées indépendamment, les résultats stockent les données dans des éléments génériques définies dans le cœur.
Ces éléments génériques sont de deux natures :
Sur ce schéma est représentée une structure de résultat permettant d’illuster la structuration par les groupes, et le stockage des données dans des items contenus dans ces groupes. A noter que pour chaque niveau de groupe, l’étape peut produire un nombre indéterminé de réalisations de cette structure. Ainsi si l’algorithme a détécté n arbres, la structure sera créée n fois, contenant à chaque fois des points et des cylindres différents, ainsi qu’un nombre de branches variable d’un arbre à l’autre.
Pour que l’ arbre d’étapes puisse être constitué intégralement avant execution, il est nécessaire que les étapes puissent communiquer entre-elles, afin de déterminer leur compatibilité.
Pour ce faire, chaque résultat est doté d’un modèle de résultat OUT décrivant sa structure :
Les étapes quant à elle sont dotées de modèles de résultats IN. Ce sont des cahiers des charges permettant à l’étape de tester des modèles de résultats OUT issus des étapes précédents, et de déterminer si elle peut les utiliser en entrée.
Sur ce schéma, les étapes 1 et 3 proviennent d’un plugin, alors que l’étape 2 provient d’un autre. Les flèches rouges représentent l’enchaînement des étapes. Les flèches bleues, la production de résultats par les étapes. Les flèches noires, les tests de compatibilité réalisés par les étapes sur les modèles de résultats OUT candidats, à l’aide de leurs modèles de résultats IN.
Les plugins peuvent étendre les fonctionnalités de Computree en fournissant des éléments d'une ou plusieurs catégories :
| Retour au sommaire | Page suivante (Types d’items) |
| ...english version of this page |
Ce tutoriel montre comment :
Pour charger le fichier, il faut ajouter une étape de chargement (début de script) à l’aide du bouton 
, puis sélectionner le fichier sample_cloud.xyb. Cela ajoute dans le gestionnaire d’étape, une étape portant le nom du fichier :
Pour charger effectivement les points en mémoire, il faut lancer le traitement à l’aide du bouton 
.
Après exécution, la barre de progression passe à 100 %, et un résultat est créé. On cochant la case correspondante, cela permet d’afficher la structure du résultat dans le gestionnaire de modèle :
Dans le gestionnaire de modèle on peut ainsi constater que l'étape de chargement a créé, au sein d'un niveau de groupe à la racine du résultat (PB_SGLF_group) :
Une fois la structure de résultat disponible dans le gestionnaire de modèles, il suffit de cocher sur une case pour afficher un élément dans la vue correspondante. Ici, comme il n’y a que le document 1 d’ouvert, il n’y a qu’une colonne “1” dans le gestionnaire de vue. En cochant Scène, les points de la scène sont affichés dans la Vue 3D du document 1.
N.B. : Par défaut la vue 3D n’est pas centrée au bon endroit pour ce nuage. Il faut donc cliquer sur le bouton 
, ce qui permet d’ajuster la vue aux données de a vue. On obtient :
Dans la vue 3D, il est possible de modifier le point de vue en maintenant appuyé le bouton gauche (rotation), le bouton droit (translation) ou avec la molette (zoom).
Exemple de point de vue plus intéressant :
Il est également possible d’afficher les intensités des points. Pour cela il faut cliquer sur le bouton 
, ce qui donne accès à la boite de dialogue qui gère la colorisation des points à partir d’attributs :
Dans cette fenêtre, les attributs disponibles sont listés. Ainsi en cliquant sur le bouton appliquer à coté de Intensité, on applique les intensités de points chargés précédemment. On obtient ainsi un nuage de points colorisé en fonction de l’intensité :
Plusieurs plugins proposent des étapes permettant d’extraire une partie de placette.
Le script HT1_Load_Crop_Export_Cloud.xsct2 utilise deux de ces étapes :
L’étape OE_StepExtractPlot propose le paramétrage suivant :
L’étape TK_StepExtractBox propose le paramétrage suivant :
Dans les deux cas on obtient une scène contenant uniquement le sous-ensemble de points contenus dans la zone sélectionnée.
Pour exporter les points il y a deux méthodes :
Le bouton 
permet d’exporter un item sélectionné au format désiré. Les éléments sélectionnés s’affiche en rouge par défaut.
Afin d’utiliser l’export automatique il suffit d’ajouter une étape du plugin plugin_base qui se trouve dans le sous-menu “Exporters” qui réalisera l’export que vous souhaitez :
Vous devez ensuite choisir l’élément que vous souhaitez exporter :
Et enfin les attributs qui seront sauvegardés par la même occasion :
| Retour à la liste des How Tos |
| ...english version of this page |
Sommaire de la documentation
| Retour à l’accueil |
| ...english version of this page |
[[computreedevtools:Fr_quickstart| Pour accéder à la procédure de mise en place d’un environnement de développement Computree, cliquez ici : ]]
La procédure décrit :
[[computreedevtools:Fr_Wiki| Le projet ComputreeDevTools fournit également : (cliquer ici pour y accéder)]]
| ...english version of this page |
[[computreedevtools:Fr_quickstart| Pour accéder à la procédure de mise en place d’un environnement de développement Computree, cliquez ici : ]]
La procédure décrit :
[[computreedevtools:Fr_Wiki| Le projet ComputreeDevTools fournit également : (cliquer ici pour y accéder)]]
| ...english version of this page |
Premiers pas avec CompuTree
ComputreeGUI est l’interface graphique standard pour Computree. Elle permet la gestion des étapes et de leurs résultats, ainsi que leur affichage paramétrable dans des vues 2D, 3D ou tabulaire.
Éléments de l’interface CompuTree:
{1} Barre de menu
{2} Barre d’outils
{3} Gestionnaire d’étapes
{4} Gestionnaire de modèle
{5} Configurateur d’items
{6} Fenêtre d’étapes
{7} Fenêtre d’affichage (vue 2D ou 3D)
{8} Vue tabulaire
{9} Gestionnaire d’actions
{10} Gestionnaire de synchronisation des vues
{11} Fenêtre de log (historique)
La barre d’outils {2} reprend sous forme d’icône la plupart des fonctionnalités présentes dans la Barre de menus {1}:
| Icone | Fonction | Raccourcis clavier |
|---|---|---|
 |
Ouvrir un fichier | CTRL + O |
 |
Afficher la fenêtre d’Étapes | F2 |
 |
Lancer les traitements | F3 |
 |
Arrêter les traitements | |
 |
Enregistrer l’arbre des étapes | CTRL + S |
 |
Valider en mode manuel | F4 |
 |
Lancer les traitements en mode debug | F5 |
 |
Lancer les traitements en mode debug et avancer de N pas | F6 |
 |
Lancer les traitements en mode debug, avancer de N pas incluant un temps d’arrêt | |
 |
Ajouter un document 3D | F7 |
 |
Ajouter un document 2D | F8 |
 |
Ajouter un document de type tableur | F9 |
 |
Configurations générales | |
 |
Nettoyer toutes les vues | F10 |
 |
Aide | F1 |
Le gestionnaire d’étape {3} est l’élément central, car il permet de créer et d’exécuter l’arbre des étapes. Ce composant permet de créer une hiérarchie d’étapes compatibles entre elles. Une fois les traitements exécutés, chaque étape porte les résultats qu’elle a créés.
La première colonne contient le nom des étapes. De petites flèches permettent de déplier et replier la hiérarchie affiliée à chaque étape. La seconde colonne permet d’activer le mode débug . La troisième colonne stocke le temps d’exécution des étapes.
Plusieurs fonctionnalités permettent de personnaliser l’interface graphique. Il est en effet possible de modifier la langue du logiciel ainsi que l’organisation des composants graphiques.
Pour modifier la langue, cliquer sur le menu Langue dans la barre de menu. Choisissez ensuite entre la version française ou anglaise du logiciel.
La majorité des composants de type “fenêtre” peuvent être déplacés dans l’interface. Ceux-ci peuvent être superposés et accessibles à l’aide d’onglets ou alors disposés en colonnes. Ces arrangements peuvent être faits de façon manuelle ou encore en utilisant les arrangements par défaut dans le menu Fenêtre de la barre de menu.
Vous pensez que votre configuration est parfaite? Soumettez-la à notre équipe, elle pourrait se retrouver dans la prochaine version de CompuTree!
Le bouton permet d’ouvrir un fichier d’arbre d’étapes (script).
Ce bouton peut également être utilisé pour ouvrir rapidement un fichier de données.
Les différentes étapes de chargement sont classifiées selon le type de données:
Étape Créer DataSource (Étape/Charger/Créer DataSource)
Un DataSource est une liste de fichiers qui permet de traiter plusieurs sources de données en parallèle.
Toutes les étapes de traitement sont situées dans la fenêtre Étapes.
Les sous onglets (de couleur bleue) permettent de classifier les étapes selon l’action ou le traitement à effectuer.
Les étapes possèdent ensuite un code couleur selon la disponibilité immédiate de l'outil:Enfin, la mise en forme du texte de l’étape permet de différentier les étapes interractives (mise en forme italique) des étapes statiques (mise en forme normal).
Pour ajouter une étape dans le gestionnaire d’étape, il suffit de double cliquer sur l’étape désirée.
L’icône 
indique que l’étape doit être lancée. Pour lancer l’étape, il suffit de cliquer sur le bouton . On peut également interrompre l’exécution à l’aide du bouton .
Pendant l’exécution, l’icône 
apparaît. L’icône 
indique que le traitement est terminé.
Lorsque l’étape est sélectionnée, celle-ci est surlignée. Pour ajouter une étape utilisant en entrée les résultats de l’étape précédente, il faut que l’étape mère soit sélectionnée.
Certaines étapes nécessitent l’identification des résultats de l’étape précédente qui seront utilisés comme entrées dans le traitement.
Par exemple, dans la fenêtre suivante, l’étape nécessite la partie végétation d’un nuage de point classifié .
La partie gauche liste les résultats candidats, classés par élément recherché.
En double-cliquant sur l’élément désiré, cela le transfert en tant que correspondance validée dans la partie droite (on peut aussi le glisser de la partie gauche vers la partie droite).
Dans la partie droite, il est possible de sélectionner, si nécessaire, au sein d’un résultat donné, les niveaux de groupes et d’items à utiliser.
Une fois tous les choix effectués, il suffit de cliquer sur OK, pour valider la configuration des résultats d’entrée.
.S’il y a lieu, la fenêtre de paramétrage de l’étape s’ouvre. Elle contient tous les paramètres réglables de l’algorithme à exécuter.
Une fois les paramètres choisis et validés, l’étape peut être lancée dans l’ arbre des étapes.
Exemple de fenêtre de paramétrage:
.Pour afficher la documentation sur une étape donnée, il faut faire un clic droit sur celle-ci, puis sélectionner 
.
Exemple d’une fenêtre de documentation:
Il est également possible d’afficher la fenêtre d’ Aide en cliquant sur .
Cette fenêtre propose entre autres un lien vers la Wiki de CompuTree.
Une fois la structure de résultat disponible dans le gestionnaire de modèles (une fois l’étape de chargement terminée), il est possible d’afficher les résultats en mode 2D, 3D et tabulaire. L’affichage de ces items peut enfin être personnalisé entre autres par leur colorisation. Une fois le résultat affiché, il est possible de naviguer dans la vue 3D.
{1} Enregistrer une capture d’écran
{2} Point de vue
{3} Exporter les éléments sélectionnés
{4} Configurer l’affichage
{5} Configurer les couleurs des éléments
{6} Changer la taille des pixels
{7} Déplacer la caméra
{8} Ajuster la caméra aux éléments visibles
{9} Centrer la vue sur le barycentre de l’élément sélectionné
{10} Centrer la vue sur le barycentre des éléments présents dans la vue
{11} Centrer la vue sur l’origine
{12} Synchroniser ce document
{13} Vue personnalisée
Il suffit de cocher sur la case d’un résultat pour afficher un élément dans la vue correspondante. Dans la figure ci-haut, comme il n’y a que le document 1 d’ouvert, il n’y a qu’une colonne “1” dans le gestionnaire de modèle. En cochant Scène, les points de la scène sont affichés dans la Vue 3D du document 1. Si un autre document est ouvert, une colonne “2” apparaîtra dans le gestionnaire de modèle. Il suffit alors de cocher l’élément désiré de la colonne “2” pour l’afficher dans le document 2.
permettent d’ajouter un nouveau document 3D, 2D ou tabulaire.
pour ramener l’item au centre du document.Pour retirer un item, il suffit de décocher l’élément dans le gestionnaire de modèle ou dans le gestionnaire d’étape.
Le bouton 
permet de nettoyer la vue de l’ensemble des éléments affichés.
Dans la vue 3D, il est possible de modifier le point de vue en maintenant appuyé le bouton gauche (rotation), le bouton droit (translation) ou avec la molette (zoom).
Il est également possible d’utiliser les points de vue préprogrammés à l’aide de l’outil 
.
Les outils 
sont très utiles à la navigation, car ils permettent de centrer la “caméra” sur un item, sur un ensemble d’items ou bien sur l’origine.
Si le nuage de points possède un attribut comme l’ Intensité, il est possible de coloriser le scan selon cet attribut. Le bouton 
permet d’ouvrir la fenêtre suivante:
Le bouton 
permet de choisir les couleurs du gradient utilisé. Il est également possible d’ajouter et de retirer des couleurs au gradient. Une fois le gradient établi, il suffit de cliquer sur le bouton 
pour appliquer le gradient sur le nuage de point.
Le bouton 
permet la configuration des valeurs MIN et MAX retenues pour l’attribut.
Exemple avec le gradient:
Pour appliquer une couleur à des items affichés dans une vue, il suffit de faire un clic droit sur l’item à coloriser. Il existe trois modes de colorisation d’un item:
Une fenêtre permettant de sélectionner la couleur désirée apparaît par la suite.
Cette méthode permet de coloriser des items avec des couleurs aléatoires.
Pour coloriser tous les items d’un même groupe, il suffit de faire le clic droit sur le groupe au lieu de l’item.
Exemple de couronnes et leurs projections au sol:
Enfin, il est possible d’appliquer une couleur sur un attribut de l’item sélectionné.
Le bouton 
permet de configurer l’apparence des documents (fenêtres de visualisation des données).
La synchronisation des vues permet d’afficher et déplacer simultanément des items dans deux documents.
)
Pour activer le mode sélection, celui-ci doit en premier lieu être activé dans la fenêtre Action:
Pour afficher les informations d’un item lors de la sélection, il suffit d’activer plutôt 
Les informations de l’item sélectionné seront alors affichées dans la fenêtre de vue:
Les options de sélection se retrouvent dans les outils de la fenêtre de vue:
Voici les différents modes de sélection:
Sélection d’un élément par simple clic
Sélection de multiples éléments par polygone
Remplacer la sélection
Ajout à la sélection existante
Supprimer de la sélection existanteTous les modes d’exportation se retrouvent dans la fenêtre Étapes au menu Exporter:
Les étapes d’exportation sont classées selon le type de données à exporter.
Un script, ou arbre d’étape, permet de sauvegarder une séquence d’étapes ainsi que le paramétrage de chaque étape pour une utilisation ultérieur.
Une fois l’arbre d’étape terminé, il suffit de cliquer sur le bouton et d’enregistrer le fichier .xsct2 dans le répertoire désiré.
Pour ouvrir un script existant, il faut simplement cliquer sur le bouton .
Il est maintenant possible de sauvegarder une liste ordonnée des outils les plus utilisés.
Dans la fenêtre Étapes se trouve un onglet Favoris:
Pour ajouter une étape dans les favoris, il suffit de faire un clic droit sur l’étape désirée et cliquer sur 
Il est possible d’ajouter des niveaux et sous-niveaux afin de classifier les favoris
| ...english version of this page |
Cette section regroupe des tutoriels (How Tos) décrivant comment réaliser dans Computree certaines opérations. Il s’agit principalement de décrire quelle succession d’étapes, issues des plugins standards, utiliser pour obtenir telle ou telle information. En général un jeu de données et un script illustratifs sont fournis.
How Tos disponibles :
| Retour à l’accueil |
| ...english version of this page |
Computree est une plateforme de traitement de nuages de points 3D, issus de capteurs LIDAR ou de traitements photogrammétriques. Elle vise à regrouper des algorithmes pour l’analyse de scènes forestières, afin d’extraire des données sur la structure des arbres et des peuplements.
Elle est gérée par l’ ONF (http://www.onf.fr), en partenariat avec l’ ENSAM de Cluny (http://www.ensam.fr/fr/centres_et_instituts/centre_cluny).
| ...english version of this page |
| Computree est une plateforme de traitement de nuages de points 3D, issus de capteurs LIDAR ou de traitements photogrammétriques. Elle vise à regrouper des algorithmes pour l’analyse de scènes forestières, afin d’extraire des données sur la structure des arbres et des peuplements. | |
| Elle est gérée par l’ ONF (http://www.onf.fr), en partenariat avec l’ ENSAM de Cluny (http://www.ensam.fr/fr/centres_et_instituts/centre_cluny). | |
| Site officiel : computree.onf.fr | |
| Vidéo de présentation de Computree | |
| ...english version of this page |
| Computree est une plateforme de traitement de nuages de points 3D, issus de capteurs LIDAR ou de traitements photogrammétriques. Elle vise à regrouper des algorithmes pour l’analyse de scènes forestières, afin d’extraire des données sur la structure des arbres et des peuplements. | |
| Elle est gérée par le Groupe Computree : | |
   |
|
  |
|
| Site officiel : computree.onf.fr | |
| Vidéo de présentation de Computree | |
| ...english version of this page |
Rappel : L’utilisation de Computree implique l’acceptation de la Chartre Computree
La version exécutable de Computree est disponible pour Windows 7/8/10 64bits uniquement.
Pour d’autres environnements (Linux en particulier), merci de vous référer aux instructions de compilation : [[computreedevtools:Fr_quickstart|aux instructions de compilation]].
Pour installer Computree :
Problème connu : Computree semble ne pas fonctionner avec certaines cartes graphiques Intel HD “anciennes” (problème OpenGL non spécifique à Computree).
N.B. : Il faut ensuite relancer CompuTreeGui pour que les plugins soient pris en compte (ou utiliser le menu A Propos / Plugins / Recharger les plugins).
| ...english version of this page |
| Computree est une plateforme de traitement de nuages de points 3D, issus de capteurs LIDAR ou de traitements photogrammétriques. Elle vise à regrouper des algorithmes pour l’analyse de scènes forestières, afin d’extraire des données sur la structure des arbres et des peuplements. | |
| Elle est gérée par le Groupe Computree : | |
   |
|
  |
|
| Site officiel : computree.onf.fr | |
| Vidéo de présentation de Computree | |
L’utilisation de Computree implique l’acceptation de la Chartre Computree
| ...english version of this page |
Version pdf de cette charte : Charte_Computree_v2018_08.pdf
La présente charte définit les modalités de fonctionnement de la plateforme Computree. Elle décrit les objectifs de la plateforme, les règles de comportement, les différents rôles au sein de la communauté Computree, ainsi que les modalités de gouvernance et de gestion de la plateforme.
L’utilisation de la plateforme Computree, ou le développement de plugins et de librairies Computree implique l’acceptation expresse des conditions de la présente Charte.
Le non-respect des dispositions de la présente charte est susceptible d’entraîner l’exclusion de la Communauté Computree.
La plateforme Computree a été initiée au printemps 2010 dans le cadre d’une collaboration entre le département Recherche, Développement et Innovation (RDI) de l’Office national des forêts (ONF) et l’Ecole nationale supérieure des arts et métiers (ENSAM) de Cluny, au sein du projet ANR Emerge. Entre 2010 et 2016 le cœur de la plateforme a été développé et maintenu sur financements majoritairement ONF, complétés par des contributions des projets ANR Emerge et Foresee. Les développements en eux-mêmes ont été réalisés par l’ONF (essentiellement algorithmes de traitement), et par l’ENSAM dans le cadre de contrats de recherche (principalement cœur de la plateforme). Initialement centrée sur le traitement des données LIDAR terrestre, la plateforme a été ouverte aux autres sources de données telles que le LIDAR aérien à partir de 2014.
En 2018, s’est organisé le transfert de la gouvernance et de la gestion de la plateforme de l’ONF vers le groupement d’intérêt public Ecofor qui a constitué un groupe Computree. Ce dernier est composé des organismes ou établissements allouant des ressources dédiées à la plateforme dans la durée (temps de personnel, contributions matérielles ou logistiques, apport financier). La partie « Modalités de gouvernance, de gestion et de fonctionnement » de cette charte décrit cet aspect de façon approfondie.
Ce transfert de gouvernance est motivé par les objectifs suivants :
Les membres fondateurs du groupe Computree sont : l’Office National des Forêts, le GIP Ecofor, l’Institut National de l’Information Géographique et Forestière, l’Institut National de la Recherche Agronomique et l’Université de Sherbrooke.
La plateforme Computree est un outil collaboratif de traitement de données dans des contextes forestiers ou de gestion des milieux naturels en général. Elle propose un environnement modulaire permettant de traiter principalement des données de télédétection : LIDAR terrestre, LIDAR aérien, photographies aériennes ou satellites, données rasters (modèles numériques de terrain, de surface ou de hauteur),… Cependant ses capacités de traitement peuvent être étendues à tout type de donnée géométrique 3D, 2D, ou attributaire.
L’objectif principal de Computree est de favoriser les synergies dans le développement et l’utilisation de méthodes de traitement des données, à des fins de description, d’analyse et d’inventaire de peuplements forestiers ou autres milieux naturels. Cet objectif se décline sous trois angles de vue complémentaires :
L’interaction entre ces trois visions est au cœur de la philosophie de la plateforme Computree.
Les fonctionnalités de la plateforme peuvent être étendues à des usages sans rapport avec les milieux naturels, via des plugins. Cependant, les ressources partagées allouées à la gestion et la maintenance de la plateforme n’interviendront pas spécifiquement dans ces domaines.
La plateforme est construite selon une architecture modulaire facilitant l’ajout de fonctionnalités par des équipes indépendantes de la communauté Computree. Ainsi, elle est composée des éléments suivants :
Un plugin et plusieurs librairies de base sont fournies en standard avec la plateforme, et contiennent les fonctionnalités essentielles à la création de chaînes de traitement (en particulier formats d’import / export).
Il n’y pas de limite au nombre de plugins ou de librairies que l’on peut ajouter à Computree. De la même façon, le système est conçu pour permettre l’utilisation de nouvelles interfaces, graphiques ou non, développées par exemple pour des usages spécifiques valorisant certains plugins uniquement.
Le principe de la plateforme est de proposer, par le biais des interfaces, la possibilité pour l’utilisateur de créer des séquences de traitement (workflows), à partir de briques unitaires nommées « étapes » contenues dans les plugins. Chaque étape permet à partir de données d’entrée, d’appliquer un algorithme pour produire des données de sortie. Ainsi, en enchaînant des étapes unitaires, potentiellement issues de différents plugins, l’utilisateur peut constituer un traitement complet adapté à ses besoins. Certaines étapes peuvent être très génériques (donc utilisables dans de nombreux contextes). D’autres sont dédiées à un usage très spécifique.
La séquence de traitement peut être intégralement constituée et sauvegardée sous forme de script, avant exécution immédiate ou décalée.
On entend par « Communauté Computree » l’ensemble des personnes physiques ou morales appelées à développer ou utiliser la plateforme Computree. Afin de clarifier les interactions au sein de la communauté Computree, la présente charte définit plusieurs « rôles Computree ». Une même personne peut avoir plusieurs rôles au même moment, ou dans le temps :
Le cœur, l’interface Batch standard ainsi que les plugins communs et les librairies communes sont diffusés sous licence open-source LGPL (Lesser General Public License). L’interface graphique standard est mise à disposition sous licence GPL (General Public License).
Ces éléments peuvent ainsi être utilisés pour tout usage professionnel ou personnel, commercial ou non, respectant les conditions de la présente Charte. Comme indiqué dans les licences LGPL et GPL, la plateforme est distribuée sans aucune garantie, ni explicite ni implicite.
Chaque plugin ou librairie (en dehors des plugins communs) est la propriété d’un auteur, d’un groupe, d’un organisme, d’un établissement, d’une société ou d’un membre de la communauté Computree qui a généré ce plugin ou librairie. Le propriétaire du plugin a toute latitude pour choisir les modalités de diffusion et les conditions d’utilisation de son plugin. L’interface graphique standard de Computree étant sous licence GPL, un plugin sous licence non compatible GPL devra soit rester en usage interne, soit proposer une interface alternative. A noter que l’interface Computree Batch n’impose aucune restriction de ce type.
La plateforme accueille donc plusieurs composantes (cœur, interfaces, plugins, librairies) de différentes natures au regard des droits de propriété intellectuelle et des droits d’utilisation qui leur sont attachés.
Les éléments centraux de la plateforme font l’objet d’une propriété partagée entre les membres actuels et passés du groupe au prorata de leur contribution totale quelle que soit leur nature (montant financier, temps de personnel mis à disposition, ressources matérielles mises à disposition, évalués financièrement) cumulée depuis le 1er janvier 2010. Elles comprennent :
L’ajout de nouveaux éléments (plugins et librairies communs) à la liste des éléments centraux ne peut être fait que par le comité stratégique, dans la mesure où ces éléments sont développés sur les ressources allouées à la plateforme. Ils font l’objet d’une propriété partagée, étant précisé que chaque membre reste titulaire des droits sur ses apports initiaux (intégration de travaux antérieurs). Une liste des éléments centraux est tenue à jour par le comité stratégique et est incluse dans le rapport d’activité annuel. Est également inclus dans ce rapport d’activité un état actualisé des contributions cumulées depuis le 1er janvier 2010, de chacun de ses membres actifs ou ayant quitté le groupe. Les contributions constatées de l’année en cours sont ajoutées au bilan, après vote à l’unanimité de leur exactitude par le comité stratégique. Ce bilan donne le détail annuel des contributions et de leur nature pour chaque membre faisant ou ayant fait partie du groupe.
Quant aux autres plugins ou librairies (cas général), la propriété intellectuelle en est gérée de façon autonome : l’appartenance au groupe Computree ne donne aucun droit sur les plugins ou librairies ne faisant pas partie de la liste des éléments centraux.
Deux comités sont institués pour assurer la gestion de la Plateforme et se réunissent une fois par an chacun.
Un Comité Technique, uniquement consultatif, a pour objectif de faire des propositions d’évolution de la plateforme pour alimenter le comité stratégique. Ce comité est animé par le gestionnaire Computree et se réunit au moins une fois par an. Tous les membres du groupe Computree sont invités à participer, et il est également ouvert à tout développeur de plugin Computree. Le gestionnaire Computree fait un bilan des évolutions de la plateforme sur l’année écoulée. Il fait également une synthèse des demandes des utilisateurs obtenues par différents canaux, dont en particulier le forum utilisateur Computree. Enfin les membres du comité technique listent les propositions d’évolutions de la plateforme pour l’année à venir et proposent des critères de priorisation.
Un Comité Stratégique, composé des membres du groupe Computree tel que définis à l’article I, se réunit au moins une fois par an. Il prend toutes les décisions concernant le groupe Computree et la gestion de ses ressources. En particulier :
Seuls les membres du Groupe COMPUTREE disposent d’un droit de vote.
Le droit de vote au comité stratégique est déterminé en fonction de l’ensemble des contributions apportées par le membre (montant financier, temps de personnel mis à disposition, ressources matérielles mises à disposition évalués financièrement), pour l’année en cours. Une voix est attribuée par tranche complète de 1000 euros. Par exception, un membre ne pourra pas se voir attribuer plus de 45 % du total des droits de vote quel que soit le montant de sa contribution.
Des conventions bipartites entre le Responsable du groupe Computree et les différents partenaires, fixent le niveau prévisionnel et la durée (pour les contributions en temps de personnel) de ces contributions.
La gestion administrative du groupe Computree est assurée par le Responsable du groupe Computree. Sa mission consiste à :
Les ressources apportées par les membres du groupe (et les éventuelles participations aux frais de séminaires demandées aux participants, décrites à l’article III.5) sont utilisées pour la maintenance et les évolutions des éléments centraux de Computree, les tests ainsi que pour l’animation de la communauté Computree, la diffusion et la documentation de la plateforme.
A noter que le développement des plugins et librairies n’est pas financé sur les ressources allouées à la plateforme, à l’exception des plugins et librairies inscrits à la liste des éléments centraux, dont le développement aura été validé par le comité stratégique et la liste tenue à jour par le gestionnaire Computree.
L’utilisation de Computree et les ressources mises à disposition pour permettre et faciliter le développement de plugins sont entièrement gratuits. Des ressources en ligne sont mises à disposition pour faciliter l’autonomie des membres de la communauté Computree. Un forum d’échange vise également à favoriser l’entraide au sein de la communauté.
Des séminaires « développeurs de plugins » sont proposés en fonction des besoins. Ils sont gratuits pour tout plugin diffusé sous licence Open-Source et restant dans les champs d’application des milieux naturels ou de la forêt. Dans tous les autres cas, ils font l’objet d’un paiement sur facture de frais de séminaires.
Chaque année, au moins un séminaire « utilisateurs Computree » est proposé à la communauté, éventuellement plusieurs selon la demande et les besoins. Ces séminaires ont pour objet d’initier les utilisateurs à l’utilisation de la plateforme Computree. Des séminaires d’approfondissement thématiques pourront également être proposés. Ces séminaires pourront faire l’objet d’un paiement sur facture de frais de séminaires occasionnés par chaque stagiaire. Afin d’en faciliter l’accès, des séminaires « utilisateurs Computree » peuvent également être proposés au catalogue de formation d’un ou plusieurs organismes membres du groupe.
Les ressources éventuellement issues de l’organisation de ces séminaires viennent abonder le budget permettant l’évolution de la plateforme. Par ailleurs, les membres de la communauté Computree ont toute liberté pour organiser leurs propres séminaires ou formations Computree.
Lorsqu’un nouveau membre souhaite intégrer le groupe Computree, un projet de convention avec le Responsable du groupe Computree – spécifiant s’il y a lieu les contributions passées aux éléments centraux de la plateforme, et dans tous les cas les contributions prévues pendant la période de la convention – est rédigé en amont de la réunion du comité stratégique. Au cours de la réunion, le comité stratégique examine et statue sur l’intégration du nouveau membre à la majorité des deux tiers. Une fois l’intégration validée et la convention entre le nouveau membre et le Responsable du groupe Computree signée par les deux parties, le nouveau membre intègre le groupe Computree et siège au comité stratégique.
Les nouveaux membres s’engagent à respecter les obligations qui leur incombent et les dispositions de la présente charte.
Les nouveaux membres s’engagent à allouer des ressources significatives (de valeur équivalente supérieure ou égale à 5 000 €/ an), sur la durée, pour maintenir ou développer les éléments centraux de la plateforme Computree. Ces ressources sont définies dans le cadre d’une convention pluriannuelle avec le Responsable du groupe Computree. Elles peuvent être de différentes natures :
Dans tous les cas, ces ressources sont converties en un montant monétaire équivalent, afin de déterminer les droits de vote de chaque membre du groupe, au prorata de sa contribution pour l’année en cours.
Dans le cas où l’un des membres manquerait aux obligations prévues dans la présente charte, et après une mise en demeure du Responsable du groupe Computree restée sans effet pendant un délai de trois mois, le Comité stratégique peut décider de son éviction (par vote à l’unanimité, le membre concerné n’étant pas pris en compte dans le vote), étant précisé que les contributions versées ne lui sont pas restituées.
Dans ce cas le Comité Stratégique mandate le Responsable du groupe Computree pour résilier la convention avec le membre concerné. La date de résiliation sera fixée autant que possible en fin d’exercice annuel.
Lors de l’arrivée à échéance de la convention de l’un des membres du groupe, ce membre peut de plein droit décider de son renouvellement (par avenant ou nouvelle convention), sauf s’il a eu un comportement en violation avec les dispositions de la présente charte.
Cependant, en cas d’augmentation de la contribution de plus de 50 %, le comité stratégique doit donner son accord pour cette augmentation par un vote à la majorité absolue, le membre concerné n’étant pas pris en compte dans le vote.
Les droits de vote seront recalculés selon les modalités définies à l’article III.2.
La plateforme Computree est mise à disposition « en l’état », sans garantie d’aucune sorte, explicite ou implicite, y compris, mais sans limitation, les garanties implicites de qualité marchande et d’adaptation à un usage en particulier. L’intégralité du risque de qualité et de performance de la plateforme est supportée par l’utilisateur. Si la plateforme est défectueuse, l’utilisateur assume seul le coût de toute réparation nécessaire.
Ainsi les membres du Groupe Computree ne sont pas responsables de l’utilisation faite par les utilisateurs de la Plateforme ou des résultats des analyses en découlant.
Aucune stipulation de la présente Charte ne pourra être interprétée comme constituant entre les les membres une entité juridique de quelque nature que ce soit, ni impliquant une quelconque solidarité entre les membres.
Les membres déclarent que la présente Charte ne peut en aucun cas être interprétée ou considérée comme constituant un acte de société, l’affectio societatis est formellement exclu.
Aucun membre n’a le pouvoir d’engager les autres membres, ni de créer des obligations à la charge des autres membres, en dehors du Responsable du groupe Computree dans le seul cadre de la mission qui lui est confiée et dans la limite des droits qui lui sont conférés.
| ...english version of this page |
La plateforme Computree (v6) est organisée en différents modules, regroupés dans un dépôt de code source svn : http://rdinnovation.onf.fr/svn/computreev6.
Ce dépôt contient les éléments suivants :
| ...english version of this page |
Computree - Principes de fonctionnement
Organisation des modules Computree
Les différents types d’items dans Computree
| ...english version of this page |
Rappel : L’utilisation de Computree implique l’acceptation de la Chartre Computree
La version exécutable de Computree est disponible pour Windows 7/8/10 64bits uniquement.
Pour d’autres environnements (Linux en particulier), merci de vous référer aux instructions de compilation : aux instructions de compilation.
Pour installer Computree :
Problème connu : Computree semble ne pas fonctionner avec certaines cartes graphiques Intel HD “anciennes” (problème OpenGL non spécifique à Computree).
N.B. : Il faut ensuite relancer CompuTreeGui pour que les plugins soient pris en compte (ou utiliser le menu A Propos / Plugins / Recharger les plugins).
| ...english version of this page |
Les grands types d’items sont définis dans les librairies ctlibstructure et ctlibstructureaddon. Entre crochets […] sont indiqués les noms correspondant aux classes dans l’interface graphique.
Tous les items de Computree héritent de la classe mère CT_AbstractSingularItemDrawable [Item]. A ce niveau les items ne sont définis que par deux attributs par défaut : un identifiant unique Computree (ID) et un nom (pour l’affichage, par défaut égale à l’ID). C’est la classe qu’on utilise quand on veut indiquer qu’on peut travailler avec tout type d’item (par exemple pour lire ses attributs).
De le classe CT_AbstractSingularItemDrawable [Item] héritent les classes abstraites suivantes :
Les formes géométriques visent à permettre l’import de données vecteur issues de Système d’Information Géographique en particulier. Il sont représentés en 3D dans un plan (réglable par l’utilisateur).
| ...english version of this page |
Computree est une plateforme de traitement de données issues de télédétection aéroportée (voire satellitaire) ou terrestre. La plateforme en elle-même propose un Framework de traitement de données fondé sur une logique de chaînes de traitement séquentielles (même si une chaîne peut avoir des ramifications).
Ainsi une chaîne de traitement est définie par une séquence d’*étapes* algorithmiques. Chaque étape :Il est ainsi possible de constituer l’ensemble de la chaîne de traitement sans l’exécuter, dans la mesure où les étapes peuvent interagir via les modèles de données, sans nécessité d’exécution de l’algorithme en lui-même. Cela permet de préparer à l’avance des traitements longs, ou de les exécuter en mode batch.
De plus le système des modèles de données permet à des étapes issues de plugins développés totalement indépendamment d’être utilisées ensembles dans une même chaîne de traitement.
De plus, Computree propose plusieurs alternatives aux « étapes standards » afin de simplifier certaines tâches :
Dans Computree les données sont organisées selon le formalisme suivant.
Les données en elles-mêmes sont stockées dans des Items, qui sont définis dans le cœur de la plateforme. La logique est qu’un item soit la plus petite entité possible, dans le but de la rendre la plus générique possible. Ainsi un item peut être : une forme géométrique 3D élémentaire (cercle, sphère, parallélépipède rectangle, cône, cylindre,…), une forme géométrique 2D élémentaire (cercle, rectangle, polygone,…), un raster, une grille voxel 3D, un nuage de point, un maillage,…
Pour les points d’un nuage ou les faces d’un maillage, l’élément unitaire stocké dans l’item est le nuage de points ou le maillage et non le point ou la face pour des raisons d’efficacité dans les traitements et de stockage en mémoire.
L’organisation des items en structures plus complexes est faite via des Groupes, dont le rôle est de construire toute structure de données nécessaire dans une étape. Ainsi un groupe peut contenir, d’une part des items, d’autres part des listes de groupes. Ainsi par composition hiérarchique il est possible de générer des structures de données complexes.
Dans ces structures de données, chaque niveau de groupe ou d’item est associé à un modèle de donnée (modèles de données de sortie décrits avant, qui permettra de l’indexer et d’y accéder.
Le premier niveau de groupe d’une structure de données est placé dans un Résultat. Une étape peut produire de 0 à n résultats.
Tout item doit être placé directement dans un groupe. Tout groupe est placé dans une liste correspondant à son modèle de donnée, soit située dans un groupe de niveau supérieur, soit à la racine du résultat.
Les items (exemple : un cylindre) contiennent un certain nombre d’attributs par défaut (exemple : centre, direction, rayon, longueur). Il est possible d’ajouter des attributs supplémentaires aux items, dans les étapes (exemple : erreur d’ajustement, type de cylindre). On ne peut pas ajouter d’attributs aux groupes.
Lorsqu’une étape a vocation à compléter un résultat d’une étape précédente (exemple : ajuster des cylindres pour chaque cluster de points), elle va faire une copie du résultat d’entrée, la compléter, et la fournir en résultat de sortie. La copie n’est pas totale, pour optimiser l’utilisation de la mémoire : les groupes sont dupliqués (nouvelle structure, potentiellement modifiée), par contre les items préexistants sont simplement référencés (pointeurs) dans les nouveaux groupes. Cette approche permet de pouvoir exporter et visualiser toute résultat intermédiaire, sans qu’il n’ait été modifié par les étapes suivantes. On peut ainsi tracer, étape par étape, les résultats produits par la chaîne de traitement.
La plateforme Computree est composée de différentes briques, dans une logique d’un design pattern Modèle Vue Contrôleur, même si dans sa version actuelle elle ne suit pas toujours ce design à la lettre pour des raisons d’efficacité (en particulier les contrôleurs ne sont pas toujours totalement isolés).
Ainsi la plateforme est composée :En lui-même le cœur de la plateforme ne contient pas d’étape, d’action, de reader, d’exporter, de filtre ou de métrique. Ces éléments sont ajoutés via des librairies (pour les readers et exporters), ou des plugins (tous les éléments, plus éventuellement des items spécifiques à un plugin donné).
Les plugins sont totalement indépendants (un plugin ne connaît que le cœur et éventuellement des librairies). Les librairies quant à elles peuvent être utilisées dans les plugins. Chaque plugin / librairie va générer une dll qui sera dynamiquement reconnue et chargée au lancement d’une des interfaces.
Pourtant les éléments implémentés dans les plugins (et librairies dans certains cas) pourront être utilisés de concert par l’utilisateur, au sein d’une même chaine de traitement (tant que leurs modèles de données coïncident).
Les plugins (ne figurant pas dans la liste de ceux maintenus par le Groupe Computree) sont développés indépendamment par les équipes / personnes qui le souhaitent. Pour les y aider, le Groupe Computree fournit la présente documentation en ligne, ainsi que des formations (web ou en présentiel). Sur demande, en fonction des ressources disponibles et dans la mesure où le plugin développé est mis à disposition de la communauté ou non, le Groupe Computree peut fournir un soutien supplémentaire aux développeurs de plugins, dont le contenu précis est à déterminer au cas par cas.
La Charte Computree décrit plus en détails la gouvernance de la plateforme. Son acceptation est un prérequis à l’utilisation de Computree.
| Retour à l’accueil |
