--- a
+++ b/Readme.md
@@ -0,0 +1,50 @@
+#DIO to BPMN Converter
+
+##Description
+
+In the numerous phases of the Timbus Project, there is the need to represent information in various formats. DIO stands for Domain Independent Ontology and [BPMN](http://www.bpmn.org/) is a standard business process notation. Acquiring a business' functioning involves two major steps regarded in Timbus Project: 
+- Acquisition of context - Contextualization of all dependencies, and its metadata - These are represented in the DIO as different Individuals.
+- Âcquisition of business processes and risks
+The two essential components of a company's functioning are then logically connected in order to understand the dependencies of a Business Process towards resources (Human or Machine).
+Hence, a format to interpret and represent the end result was created - the iERM. This format provides other vital tools and characteristics, but here we'll focus on what's relevant for this tool.
+The DIO to BPMN converter was, then, developed, for cases in which business processes are represented in DIO in order to easily integrate them with the iERM. 
+
+ 
+
+##How to get the code
+
+	git clone https://@opensourceprojects.eu/git/p/timbus/context-model/converters/diotobpmn
+
+ 
+
+##Usage
+
+The converter is a command-line tool. It requires one unique input, the source OWL file containing the DIO populated file ('-s'). In this case, an output with a standard name and conversion is created within the projects' folder.
+Optional parameters:
+- Config file ('-c'): In order to convert from DIO to BPMN, an effort to translate DIO classes to BPMN types was made. A JSON config file might be inputed to override default correspondence. The default config is the following:
+
+	#!json
+		{
+		Activity:["BusinessActivity","BusinessProcess"],
+		Start:["BusinessEvent"],
+		End:["BusinessEvent"],
+		}
+		
+- Destination file ('-d'): The name of the output bpmn file
+- Whether inference concerning Start and End events is desired ('-i')
+ 
+
+##License
+
+Copyright (c) 2014, Caixa Magica Software Lda (CMS).
+The work has been developed in the TIMBUS Project and the above-mentioned are Members of the TIMBUS Consortium.
+TIMBUS is supported by the European Union under the 7th Framework Programme for research and technological development and demonstration activities (FP7/2007-2013) under grant agreement no. 269940.
+
+Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at:   http://www.apache.org/licenses/LICENSE-2.0 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied, including without limitation, any warranties or conditions of TITLE, NON-INFRINGEMENT, MERCHANTIBITLY, or FITNESS FOR A PARTICULAR PURPOSE. In no event and under no legal theory, whether in tort (including negligence), contract, or otherwise, unless required by applicable law or agreed to in writing, shall any Contributor be liable for damages, including any direct, indirect, special, incidental, or consequential damages of any character arising as a result of this License or out of the use or inability to use the Work.
+See the License for the specific language governing permissions and limitation under the License.
+
+ 
+
+##Authors
+
+Miguel Gama Nunes <miguel.nunes@caixamagica.pt>