biomasfor Files

#--------------------------------------------------------------------------#
#              _     _                           _  _                      #
#             | |   (_)                         | || |                     #
#             | |__  _  ___  _ __ ___   __ _ ___| || |_                    #
#             | '_ \| |/ _ \| '_ ` _ \ / _` / __|__   _|                   #
#             | |_) | | (_) | | | | | | (_| \__ \  | |                     #
#             |_.__/|_|\___/|_| |_| |_|\__,_|___/  |_|                     #
#                                                                          #
#  Pietro Zambelli  -----------------------------------  01 September 2010 #


This software is provided "as is" and any expressed or implied warranties,
including, but not limited to, the implied warranties of merchantability and
fitness for a particular purpose are disclaimed. in no event shall the regents
or contributors be liable for any direct, indirect, incidental, special,
exemplary, or consequential damages (including, but not limited to,
procurement of substitute goods or services; loss of use, data, or profits;
or business interruption) however caused and on any theory of liability,
whether in contract, strict liability, or tort (including negligence or
otherwise) arising in any way out of the use of this software, even if advised
of the possibility of such damage.

You can found more info on te software use at the wikipage of the project:
http://sourceforge.net/p/biomasfor/wiki/Home/

Find more info about the biomasfor project:
http://www.biomasfor.org/english


Structure of the script
##########################

biomas4.py
==================

Contains:
* the GUI description using SWIG;
* the function `convertV2ton` to convert volume to ton
* the function `printresult` to print volume results
* `main` to call all the command sequence, for both:

   - Ground-based harvesting

      ‣ `cluster.mkcluster` to identify the cluster areas, using the `sql`
        library;
      ‣ `commandsequence.joinroads` to join main and forestry roads;
      ‣ `general.TransformToPoints`
      ‣ `commandsequence.distdisl` to excute the SQL necessary to compute
        the distance and the drop from the closest road point;
      ‣ `commandsequence.methods` implement method 1 and 2 to transform the
        area available for harvesting to volume;
      ‣ `statistic.sumByPercentage` compute some statistics;
      ‣ `commonfunction.printTab` print the statistic table.

   - Cable harvesting

      ‣ `cablecrane.maingrass` a function to identify the exploitable area
        using a cable harvesting that return a `csv` file with the `gid` of
        the compartment, and the number of pixel that satisfy the harvesting
        cable conditions;
      ‣ `cablecrane.mainpg` function to import the csv data in the database;
      ‣ `cablecrane.mkParticelTab` compute the percentage table of the
        exploitable area;
      ‣ `commandsequence.methods` implement method 1 and 2 to transform the
        area available for harvesting to volume;
      ‣ `statistic.sumByPercentage` compute some statistics;
      ‣ `commonfunction.printTab` print the statistic table.

In order to simplify the use of the GRASS module, a new version is under
development, to use only GRASS function without the need of PostGIS/PostgreSQL.
Stay tuned!



License
=========

See LICENSE file in the source directory.