Tidying up the repository

README.md

@@ -1,9 +1,33 @@
-# [Soil](https://github.com/gsi-upm/soil)
+[![SOIL](logo_gsi.png)](https://www.gsi.dit.upm.es)
+
+# [SOIL](https://github.com/gsi-upm/soil)
 
 Soil is an extensible and user-friendly Agent-based Social Simulator for Social Networks.
 Learn how to run your own simulations with our [documentation](http://soilsim.readthedocs.io).
 
 Follow our [tutorial](notebooks/soil_tutorial.ipynb) to develop your own agent models.
 
+If you use Soil in your research, don't forget to cite this paper:
+
+```bibtex
+@inbook{soil-gsi-conference-2017,
+    author = "S{\'a}nchez, Jes{\'u}s M. and Iglesias, Carlos A. and S{\'a}nchez-Rada, J. Fernando",
+    booktitle = "Advances in Practical Applications of Cyber-Physical Multi-Agent Systems: The PAAMS Collection",
+    doi = "10.1007/978-3-319-59930-4_19",
+    editor = "Demazeau Y., Davidsson P., Bajo J., Vale Z.",
+    isbn = "978-3-319-59929-8",
+    keywords = "soil;social networks;agent based social simulation;python",
+    month = "June",
+    organization = "PAAMS 2017",
+    pages = "234-245",
+    publisher = "Springer Verlag",
+    series = "LNAI",
+    title = "{S}oil: {A}n {A}gent-{B}ased {S}ocial {S}imulator in {P}ython for {M}odelling and {S}imulation of {S}ocial {N}etworks",
+    url = "https://link.springer.com/chapter/10.1007/978-3-319-59930-4_19",
+    volume = "10349",
+    year = "2017",
+}
+
+```
 
 @Copyright GSI - Universidad Politécnica de Madrid 2017