View source for SimpleGraph

{{SimpleArticle|title=SimpleGraph|text={{OsProject|id=com.bitplan.simplegraph|owner=BITPlan|title=SimpleGraph System API wrapper|url=https://github.com/BITPlan/com.bitplan.simplegraph|version=0.0.5|date=2019-03-23}}
is an open source project that allows to wrap Systems APIs in a way that graph algorithms and storage can be applied. As an implementation [http://tinkerpop.apache.org Apache Tinkerpop/Gremlin] is used.}}

{{:SimpleGraph/Links}}

SimpleGraph uses the [http://www.enterpriseintegrationpatterns.com/ramblings/03_hubandspoke.html Hub and Spoke] and Adapter patterns heavily.

http://www.enterpriseintegrationpatterns.com/img/IntegrationSpaghetti.gif
http://www.enterpriseintegrationpatterns.com/img/MessageBroker.gif

= Modules =
There are currently {{#ask: [[Concept:SimpleGraphModule]]|format=count}} Modules available for SimpleGraph. 
Each module wraps an "external" API to make the functions and data behind that API available for graph processing with Apache Tinkerpop / Gremlin.
== Module Hub and Spoke ==
{{:SimpleGraphModuleHubAndSpoke}}

== Module Details ==
{{SimpleGraphModuleMarkup|#userparam=intro}}
{{#ask: [[Concept:SimpleGraphModule]]
| mainlabel=SimpleGraphModule
| ?SimpleGraphModule name = name
| ?SimpleGraphModule modulename = modulename
| ?SimpleGraphModule systemname = systemname
| ?SimpleGraphModule logo = logo
| ?SimpleGraphModule apiname = apiname
| ?SimpleGraphModule apiurl = apiurl
| ?SimpleGraphModule url = url
| ?SimpleGraphModule documentation = documentation
| sort=SimpleGraphModule name
| format=template
| link=none
| userparam=row
| named args=yes
| template=SimpleGraphModuleMarkup
}}
{{SimpleGraphModuleMarkup|#userparam=outro}}

= Introduction =
{{SimpleArticle|title=Motivation|text=Solving IT Problems across System boundaries can get very difficult. There may be a wealth of APIs which first looks helpful but given the diversity of approaches
it a daunting task will need to be tackled to get reasonable results. More often than not projects are not even started since the cost/benefit ratio is not good enough. 
SimpleGraph aims to supply a unified graph API access to Systems for which this makes sense. In fact for most systems it makes sense to have a graph API. Quite a few problems will get much easier to solve if the subdivision of the problem is done with the goal to apply graph algorithms.
See {{Link|target=SiGNaL#What_happens_if_you_view_the_world_as_a_graph.3F|title=What happens if you see the world as a graph?}}
}}

{{SimpleArticle|title=Use Cases|text=
== Mix and Match Office and other data ==
Let's assume we have a business that works in the following manner:
# There are pricelist for product categories in Microsoft Excel files
# Product specifications are in PDF Format - the files are referenced in the Excel files
# Invoices are written in Microsoft Word
# There is an address book of customers in VCard format
# Orders are handled via e-mail (that is automatically produced by the companies shop website)
# Monthly reports are created with PowerPoint
The monthly reports should in the future be modified to give geographical information. Basically a revenue/region sales count per product/region information is wanted.

The 1000 dollar question - can this report be created efficiently semi-manually with reasonable software effort?
Sadly it sounds more like 10.000 or 100.000 dollar question. 

There are at least 6 different systems involved. 
SimpleGraph simplifies accessing all 6 systems.
}}
{{SimpleArticle|title=Examples|text=
== Air Routes ==
The AirRoutes example is taken from [http://kelvinlawrence.net/book/Gremlin-Graph-Guide.html Practical Gremlin: An Apache TinkerPop Tutorial by Kelvin Lawrence] see also https://github.com/krlawrence/graph. 
<uml>
  hide circle
  package AirRoutes {
  	note top of airport: 3374
  	class airport {  	
  	  	country 
  	  	code 
  	  	longest 
  	  	city 
  	  	elev 
  	  	icao 
  	  	lon 
  	  	type 
  	  	region 
  	  	runways 
  	  	lat 
  	  	desc 
  	}
  	note top of version: 1
  	class version {  	
  	  	code 
  	  	type 
  	  	desc 
  	}
  	note top of country: 237
  	class country {  	
  	  	code 
  	  	type 
  	  	desc 
  	}
  	note top of continent: 7
  	class continent {  	
  	  	code 
  	  	type 
  	  	desc 
  	}
  }

  airport --> airport: route
  note on link: 43400

  continent --> airport: contains
  note on link: 6748
</uml>

== JUnit Test case ==
We'd like to read in the air-routes graph described above and create an Excel Work book from it.
see [https://github.com/BITPlan/com.bitplan.simplegraph/blob/master/simplegraph-excel/src/test/java/com/bitplan/simplegraph/excel/TestExcelSystem.java TestExcelSystem.java]
=== Java Source Code ===
<source lang='java'>
  ExcelSystem es = new ExcelSystem();
  Graph graph = TestTinkerPop3.getAirRoutes();
  GraphTraversalSource g = graph.traversal();
  Workbook wb = es.createWorkBook(g);
  assertEquals(6, wb.getNumberOfSheets());
  es.save(wb, testAirRouteFileName);
</source>
View the resulting [[File:Air-routes.xlsx]] Excel file to
see what the tabular version of the graph looks like.
}}
= Links =
* [https://stackoverflow.com/questions/tagged/simplegraph SimpleGraph Stackoverflow Questions]
* [https://groups.google.com/forum/#!forum/simplegraph Google SimpleGraph Discussion Group]

= Documentation =
{{Article|title=Links|text=
* {{Link|target=SimpleGraph-Installation}}
* {{Link|target=SimpleGraph-Tutorial}}
* {{Link|target=SimpleGraph-Core}}
}}
[[Category:frontend]]
[[Category:SiGNaL]]
[[Category:SimpleGraph]]