Natural language generation from class diagrams

ABSTRACT

A Platform-Independent Model (PIM) is supposed to capture the requirements specified in the Computational Independent Model (CIM). It can be hard to validate that this is the case since the stakeholders might lack the necessary training to access the information of the software models in the PIM. In contrast, a description of the PIM in natural language will enable all stakeholders to be included in the validation.

We have conducted a case study to investigate the possibilities to generate natural language text from Executable and Translatable UML. In our case study we have considered a static part of the PIM; the structure of the class diagram. The transformation was done in two steps. In the first step, the class diagram was transformed into an intermediate linguistic model using Grammatical Framework. In the second step, the linguistic model is transformed into natural language text. The PIM was enhanced in such a way that the generated texts can both paraphrase the original software models as well as include the underlying motivations behind the design decisions.

References

1. S. Andersson and T. Siljamäki. Proof of concept - reuse of PIM, experience report. In SPLST'09 & NW-MODE'09: Proceedings of 11th Symposium on Programming Languages and Software Tools and 7th Nordic Workshop on Model Driven Software Engineering, Tampere, Finland, August 2009.
2. J. Arlow, W. Emmerich, and J. Quinn. Literate Modelling - Capturing Business Knowledge with the UML. In Selected papers from the First International Workshop on The Unified Modeling Language UML'98: Beyond the Notation, pages 189--199, London, UK, 1999. Springer-Verlag.
3. BridgePoint. http://www.mentor.com/. Accessed 8th March 2011.
4. B. Bringert, R. Cooper, P. Ljunglöf, and A. Ranta. Multimodal dialogue system grammars. In Proceedings of DIALOR'05, Ninth Workshop on the Semantics and Pragmatics of Dialogue, pages 53--60, June 2005.
5. P. Brosch and A. Randak. Position paper: m2n-a tool for translating models to natural language descriptions. Electronic Communications of the EASST, Software Modeling in Education at MODELS 2010(34), 2010.
6. D. A. Burke and K. Johannisson. Translating formal software specifications to natural language. In P. Blache, E. P. Stabler, J. Busquets, and R. Moot, editors, LACL, volume 3492 of Lecture Notes in Computer Science, pages 51--66. Springer, 2005.
7. J. Cabot, R. Pau, and R. Raventós. From uml/ocl to sbvr specifications: A challenging transformation. Inf. Syst., 35(4):417--440, 2010.
8. C. Fellbaum and G. A. Miller. WordNet: An electronic lexical database. MIT Press, Cambridge, MA, 1998.
9. D. Firesmith. Modern requirements specification. Journal of Object Technology, 2(2):53--64, 2003.
10. R. Hähnle, K. Johannisson, and A. Ranta. An authoring tool for informal and formal requirements specifications. In R.-D. Kutsche and H. Weber, editors, FASE, volume 2306 of Lecture Notes in Computer Science, pages 233--248. Springer, 2002.
11. C. F. J. Lange, B. D. Bois, M. R. V. Chaudron, and S. Demeyer. An experimental investigation of UML modeling conventions. In O. Nierstrasz, J. Whittle, D. Harel, and G. Reggio, editors, MoDELS, volume 4199 of Lecture Notes in Computer Science, pages 27--41. Springer, 2006.
12. S. Larsson and J. Villing. The dico project: A multimodal menu-based in-vehicle dialogue system. In Proceedings of the 7th International Workshop on Computational Semantics (IWCS-7), Tilburg, The Netherlands. IWCS, 2007.
13. P. Ljungläf. Editing syntax trees on the surface. In Nodalida'11: 18th Nordic Conference of Computational Linguistics, volume 11, Riga, Latvia, 2011. NEALT Proceedings Series.
14. S. J. Mellor and M. Balcer. Executable UML: A Foundation for Model-Driven Architectures. Addison-Wesley Longman Publishing Co., Inc., Boston, MA, USA, 2002.
15. S. J. Mellor, S. Kendall, A. Uhl, and D. Weise. MDA Distilled. Addison Wesley Longman Publishing Co., Inc., Redwood City, CA, USA, 2004.
16. F. Meziane, N. Athanasakis, and S. Ananiadou. Generating Natural Language Specifications from UML Class Diagrams. Requir. Eng., 13(1):1--18, 2008.
17. J. Miller and J. Mukerji. MDA Guide Version 1.0.1. Technical report, Object Management Group (OMG), 2003.
18. P. Mohagheghi and J. Aagedal. Evaluating quality in model-driven engineering. In MISE '07: Proceedings of the International Workshop on Modeling in Software Engineering, page 6, Washington, DC, USA, 2007. IEEE Computer Society.
19. Molto - Multilingual On-line Translation. http://www.molto-project.eu/. Accessed 1st July 2011.
20. P. Naur. Programming as theory building. Microprocessing and Microprogramming, 15(5):253--261, 1985.
21. J. Nicolás and J. A. T. Álvarez. On the generation of requirements specifications from software engineering models: A systematic literature review. Information & Software Technology, 51(9):1291--1307, 2009.
22. OMG. Object Constraint Language Version 2.2. http://www.omg.org/spec/OCL/2.2/. Accessed 13th September 2010.
23. OMG. OMG Unified Modeling Language (OMG UML) Infrastructure Version 2.3. http://www.omg.org/spec/UML/2.3/. Accessed 11th September 2010.
24. OMG. Semantics of Business Vocabulary and Rules (SBVR) Version 1.0, ormal/08-01-02 edition, January 2008.
25. OMG. MDA. http://www.omg.org/mda/, Accessed January 2011.
26. D. E. Perry and A. L. Wolf. Foundations for the study of software architecture. SIGSOFT Softw. Eng. Notes, 17:40--52, October 1992.
27. C. Raistrick, P. Francis, J. Wright, C. Carter, and I. Wilkie. Model Driven Architecture with Executable UML#8482;. Cambridge University Press, New York, NY, USA, 2004.
28. A. Ranta. Grammatical Framework: Programming with Multilingual Grammars. CSLI Publications, Stanford, 2011.
29. E. Reiter and R. Dale. Building applied natural language generation systems. Nat. Lang. Eng., 3:57--87, March 1997.
30. S. Shlaer and S. J. Mellor. Object lifecycles: modeling the world in states. Yourdon Press, Upper Saddle River, NJ, USA, 1992.
31. T. Siljamäki and S. Andersson. Performance benchmarking of real time critical function using BridgePoint xtUML. NW-MoDE'08: Nordic Workshop on Model Driven Engineering. Reykjavik, Iceland, August 2008.
32. G. Sridhara, E. Hill, D. Muppaneni, L. Pollock, and K. Vijay-Shanker. Towards automatically generating summary comments for java methods. In Proceedings of the IEEE/ACM international conference on Automated software engineering, ASE '10, pages 43--52, New York, NY, USA, 2010. ACM.
33. L. Starr. How to build articulate UML class models. http://knol.google.com/k/leon-starr/how-to-build-articulate-uml-class-models/2hnjef6cmm971/4. Accessed 24th November 2009.
34. L. Starr. Executable UML: How to Build Class Models. Prentice Hall PTR, Upper Saddle River, NJ, USA, 2001.
35. The TALK Project. http://www.talk-project.org/. Accessed 1st July 2011.
36. J. Warmer and A. Kleppe. The Object Constraint Language: Getting Your Models Ready for MDA. Addison-Wesley Longman Publishing Co., Inc., Boston, MA, USA, 2 edition, 2003.

Index Terms

• Computing methodologies

  • Artificial intelligence

    • Natural language processing

      • Natural language generation

  • Modeling and simulation

    • Model development and analysis

      • Model verification and validation

• General and reference

  • Cross-computing tools and techniques

    • Validation

• Software and its engineering

  • Software creation and management

    • Software post-development issues

      • Documentation

      • Software reverse engineering

    • Software verification and validation

      • Empirical software validation

      • Process validation