Recent changes to Main_Page

Discussion for Main_Page page

Olivier Cailloux — Wed, 21 May 2014 21:06:19 -0000

Code for picture (outdated): [[File:J-MCDA-project-libraries.png|250px|right|The libraries dependencies illustrated.]]

How to start? (outdated)

Find a code sample relevant to the task you want to achieve and adapt it to your needs while reading the relevant javadoc parts.

You want to build an export for a custom (non XMCDA) file format: look at the example from the class org.decisiondeck.xmcda_oo.utils.IrisExport in J-MCDA.
You want to use the command line tool to generate XMCDA files from CSV files:
- Get the CSV file. An example CSV file is there. One way to create a correct CSV file is to use OpenOffice calc, save as CSV, decimal separator must be dot (use e.g. english linguistics), export parameters for the CSV filter: UTF-8, field-sep comma, text-sep double quote, raw cell data (do not record cell 'as is'). With Excel this should be similar.
- Download (at least version 0.3) from J-MCDA, extract somewhere.
- Under Linux, type java -classpath "$rootMCDA/lib/*:$rootMCDA/conf" org.decisiondeck.xmcda_oo.utils.CSVToXMCDA, where $rootMCDA is the folder where you extracted J-MCDA.
- Under Windows, type java -classpath "%rootMCDA\lib\*;%rootMCDA\conf" org.decisiondeck.xmcda_oo.utils.CSVToXMCDA, where %rootMCDA is the folder where you extracted J-MCDA.
- You should get a message explaining the syntax (saying what you need to add behind the preceding line to specify what to convert).
You want to do something not yet documented? Ask for help on the forum (see below). This project is only starting so help us document things properly by pointing out what is lacking.

Main_Page modified by Olivier Cailloux

Olivier Cailloux — Wed, 21 May 2014 21:06:19 -0000

--- v42
+++ v43
@@ -39,7 +39,7 @@

 ## Import CSV files

-The J-MCDA module may be used to programmatically import [CSV](http://en.wikipedia.org/wiki/Comma-separated_values) files. Their content is then available as Java objects. See e.g. class [CsvImporterEvaluations](http://j-mcda.svn.sourceforge.net/viewvc/j-mcda/trunk/J-MCDA/jmcda-base/src/main/java/org/decisiondeck/jmcda/persist/text/CsvImporterEvaluations.java?revision=166&view=markup). The XMCDA module may then be used to programmatically convert such CSV files into XMCDA files. 
+The J-MCDA module may be used to programmatically import [CSV](http://en.wikipedia.org/wiki/Comma-separated_values) files. Their content is then available as Java objects. See e.g. class [CsvImporter](http://j-mcda.svn.sourceforge.net/viewvc/j-mcda/trunk/J-MCDA/jmcda-base/src/main/java/org/decisiondeck/jmcda/persist/text/CsvImporter.java?view=markup). The XMCDA module may then be used to programmatically convert such CSV files into XMCDA files. 

 For end-user easy access, an XMCDA web service is available to do the job. It can be accessed through e.g. the diviz software. The web service converts a performance table, or evaluations table, into equivalent XMCDA tags. One way to create a correct CSV file is to use OpenOffice calc, save as CSV, decimal separator must be dot (use e.g. english linguistics), export parameters for the CSV filter: UTF-8, field-sep comma, text-sep double quote, raw cell data (do not record cell 'as is'). The first column must contain the alternatives names, the first row must contain the criteria names. The evaluations must be numerical. The web service accepts missing values, and even empty evaluations, in which case only the criteria and alternatives are set. It also accepts a completely empty row or column, as long as all headers (rows and columns) are set.

Main_Page modified by Olivier Cailloux

Olivier Cailloux — Wed, 21 May 2014 21:06:19 -0000

--- v41
+++ v42
@@ -31,6 +31,12 @@

 To use the J-MCDA libraries as a basis to provide your own XMCDA web service, read [this page](How_to_-_XMCDA_web_services). 

+## Read and write XMCDA files
+
+To read XMCDA files, use one of these two strategies. The quickest way, useful if you want to publish XMCDA web services, is to use the automated parsing. Read the page here above (see XMCDA web services). 
+
+If you do not want to publish XMCDA web services, but simply want to read XMCDA files (e.g. to integrate XMCDA support in a software), or if you want supplementary flexibility (at the price of a bit much work), you may parse the files without using the automated XMCDA web services support. Read [this page](How_to_-_XMCDA_files). 
+
 ## Import CSV files

 The J-MCDA module may be used to programmatically import [CSV](http://en.wikipedia.org/wiki/Comma-separated_values) files. Their content is then available as Java objects. See e.g. class [CsvImporterEvaluations](http://j-mcda.svn.sourceforge.net/viewvc/j-mcda/trunk/J-MCDA/jmcda-base/src/main/java/org/decisiondeck/jmcda/persist/text/CsvImporterEvaluations.java?revision=166&view=markup). The XMCDA module may then be used to programmatically convert such CSV files into XMCDA files.

Main_Page modified by Olivier Cailloux

Olivier Cailloux — Wed, 21 May 2014 21:06:19 -0000

--- v40
+++ v41
@@ -33,11 +33,11 @@

 ## Import CSV files

-The J-MCDA module may be used to programmatically import [CSV](http://en.wikipedia.org/wiki/Comma-separated_values) files. Their content is then available as Java objects. See e.g. class org.decisiondeck.jmcda.persist.text.CsvImporterEvaluations. The XMCDA module may then be used to programmatically convert such CSV files into XMCDA files. 
+The J-MCDA module may be used to programmatically import [CSV](http://en.wikipedia.org/wiki/Comma-separated_values) files. Their content is then available as Java objects. See e.g. class [CsvImporterEvaluations](http://j-mcda.svn.sourceforge.net/viewvc/j-mcda/trunk/J-MCDA/jmcda-base/src/main/java/org/decisiondeck/jmcda/persist/text/CsvImporterEvaluations.java?revision=166&view=markup). The XMCDA module may then be used to programmatically convert such CSV files into XMCDA files. 

 For end-user easy access, an XMCDA web service is available to do the job. It can be accessed through e.g. the diviz software. The web service converts a performance table, or evaluations table, into equivalent XMCDA tags. One way to create a correct CSV file is to use OpenOffice calc, save as CSV, decimal separator must be dot (use e.g. english linguistics), export parameters for the CSV filter: UTF-8, field-sep comma, text-sep double quote, raw cell data (do not record cell 'as is'). The first column must contain the alternatives names, the first row must contain the criteria names. The evaluations must be numerical. The web service accepts missing values, and even empty evaluations, in which case only the criteria and alternatives are set. It also accepts a completely empty row or column, as long as all headers (rows and columns) are set. 

-An example input file is /jmcda-base/src/test/resources/org/decisiondeck/jmcda/persist/text/interviews_2009.csv. 
+An [example input file](http://j-mcda.svn.sourceforge.net/viewvc/j-mcda/trunk/J-MCDA/jmcda-base/src/test/resources/org/decisiondeck/jmcda/persist/text/interviews_2009.csv?revision=166&view=markup) is available. 

 ## Other places for information

Main_Page modified by Olivier Cailloux