Distribution contents

Resources in the distribution and resources available on shapechange.net

Earlier versions of ShapeChange included more resources in the distribution package. Most of these are now simply accessed from shapechange.net when needed. The main benefit is that improvements made to the central files are available to everyone immediately. This page describes both the resources in the distribution package and on shapechange.net.

If there is a need to run ShapeChange without internet connection, you can also download copies of the resources on shapechange.net and redirect the references in the configuration files to your local copies.

Content of the distribution package

The ShapeChange distribution package contains the following files and folders:

FileDescription
ShapeChange-X.Y.Z.jarThe ShapeChange software packaged as a JAR file.
ShapeChange-X.Y.Z-sources.jarThe ShapeChange source code.
LICENSEThe license of this ShapeChange distribution - the GNU Public License v3.
libFolder containing libraries needed by ShapeChange.
testFolder for resources to test the installation.
test/test.xmiTest model in XMI 1.0  format. This is a copy of https://shapechange.net/resources/test/test.xmi.
test/UMLX13.dtdDTD referenced from the XMI 1.0 test model. The DTD is required to process XMI 1.0 models in ShapeChange.
test/test.eapTest model in Enterprise Architect format. This is a copy of https://shapechange.net/resources/test/test.eap.

NOTE: X.Y.Z is a placeholder for the version of ShapeChange that is contained in a specific distribution

Resources available on shapechange.net

All other resources that are commonly accessed by ShapeChange are available on shapechange.net in the resources folder. These are:

FileDescription
configFolder containing basic, reusable fragments for configuration files. These can be included in project configuration files using XInclude. More details on configuration files are described here. Example configuration files can be found in the test folder and the examples folder.
config/DescriptorSourcesInspire.xml(since 2.0.2) An example configuration for the source of descriptive information about model elements as used in the INSPIRE application schemas.
config/minimal.xmlThis file is a minimal configuration file that will be used, if ShapeChange is invoked without parameters, for example, by double-clicking the JAR file.
config/StandardAliases.xmlThis file specifies typical aliases for well-known stereotypes and is typically included in a project configuration file. This also handles different writing styles for stereotype names, e.g. <<featureType>> vs. <<Feature Type>>. Additional aliases may be specified in a project configuration file.
config/StandardJsonMapEntries.xmlIncludes the standard map entries for the JSON encoding rule. Additional mappings can be defined in project configurations - or added to these central mapping files.
config/StandardMapEntries-v21.xmlIncludes map entries configuration files for GML 2.1 schema encoding. Additional mappings can be defined in project configurations - or added to these central mapping files.
config/StandardMapEntries-v31.xmlIncludes map entries configuration files for GML 3.1 schema encoding. Additional mappings can be defined in project configurations - or added to these central mapping files.
config/StandardMapEntries.xmlIncludes map entries configuration files for GML 3.2 (and above) schema encoding. This provides standard XML Schema implementations for many types from ISO/TC 211 and OGC standards that are used in application schemas. Additional mappings can be defined in project configurations - or added to these central mapping files.
config/StandardMapEntries_gml21.xmlMap entries for basic types (e.g. from ISO 19103) according to the GML 3.2 / ISO 19136 encoding rule, based on GML 2.1.
config/StandardMapEntries_gml31.xmlMap entries for basic types (e.g. from ISO 19103) according to the GML 3.2 / ISO 19136 encoding rule, based on GML 3.1.
config/StandardMapEntries_gmlcov.xmlMap entries for mapping types from the GMLCOV standard to their implementations.
config/StandardMapEntries_gsip.xmlMap entries for basic types according to the GSIP encoding rule
config/StandardMapEntries_iso19107-v21.xmlMap entries for mapping types from ISO 19107 (spatial schema) to their GML (2.1) implementations.
config/StandardMapEntries_iso19107-v31.xmlMap entries for mapping types from ISO 19107 (spatial schema) to their GML (3.1) implementations.
config/StandardMapEntries_iso19107.xmlMap entries for mapping types from ISO 19107 (spatial schema) to their GML (3.2 and above) implementations and their ISO/TS 19139 GSS implementations.
config/StandardMapEntries_iso19108-v31.xmlMap entries for mapping types from ISO 19108 (temporal schema) to their GML (3.1) implementations.
config/StandardMapEntries_iso19108.xmlMap entries for mapping types from ISO 19108 (temporal schema) to their GML (3.2 and above) implementations and their ISO/TS 19139 GTS implementations.
config/StandardMapEntries_iso19111-v31.xmlMap entries for mapping types from ISO 19111 (coordinate reference systems) to their GML (3.1) implementations.
config/StandardMapEntries_iso19111.xmlMap entries for mapping types from ISO 19111 (coordinate reference systems) to their GML (3.2 and above) implementations.
config/StandardMapEntries_iso19115-v21.xmlMap entries for mapping types from ISO 19115 (metadata) to their GML (2.1) implementations.
config/StandardMapEntries_iso19115.xmlMap entries for mapping types from ISO 19115 (metadata) to their ISO/TS 19139 implementations.
config/StandardMapEntries_iso19123-v31.xmlMap entries for mapping types from ISO 19123 (coverages) to their GML (3.1) implementations.
config/StandardMapEntries_iso19123.xmlMap entries for mapping types from ISO 19123 (coverages) to their GMLCOV implementations.
config/StandardMapEntries_iso19136_2007.xmlMap entries for basic types according to the GML 3.2 / ISO 19136 encoding rule.
config/StandardMapEntries_iso19139_2007.xmlMap entries for basic types according to the ISO/TS 19139 encoding rule.
config/StandardMapEntries_iso19156.xmlMap entries for mapping types from ISO 19158 (observation and measurements) to their OMXML implementations.
config/StandardMapEntries_sweCommon.xmlIncludes the standard map entries for the SWE Common Data Model 2.0 encoding rule. Additional mappings can be defined in project configurations - or added to these central mapping files."
config/StandardNamespaces-v21.xmlLists namespaces commonly imported from GML 2.1 application schemas. The GML namespace must be specified in any ShapeChange configuration. If you want to create a GML 2.1 application schema, include this file in your configuration.
config/StandardNamespaces-v31.xmlLists namespaces commonly imported from GML 3.1 application schemas. The GML namespace must be specified in any ShapeChange configuration. If you want to create a GML 3.1 application schema, include this file in your configuration.
config/StandardNamespaces.xmlLists namespaces commonly imported from GML 3.2/3.3 application schemas. The GML namespace must be specified in any ShapeChange configuration. If you want to create a GML 3.2/3.3 application schema, include this file in your configuration.
config/StandardRules.xmlSpecifies some pre-defined XML Schema encoding rules.
config/StandardTagAliases.xml(since 2.0.2) This file specifies typical aliases for well-known descriptor tags and may be included in a project configuration file. Additional aliases may be specified in a project configuration file.
distFolder for the ShapeChange distribution files (JAR and ZIP archives).
exampleFolder for examples.
schemaFolder for XML Schema documents
schema/ShapeChangeConfiguration.xsdXML Schema for ShapeChange configuration files.
schema/ShapeChangeAppinfo.xsdXML Schema for elements embedded by ShapeChange in appinfo annotations.
schema/ShapeChangeResult.xsdXML Schema for the log files created by ShapeChange.
schema/w3c/XInclude.xsdXML Schema for XInclude published by W3C.
templatesFolder for template files used by ShapeChange.
templates/template.docxTemplate file that can be used to create a feature catalogue output of an application schema in DOCX format."
testFolder for resources to test a ShapeChange installation.
test/test.xmiTest model in XMI 1.0  format.
test/UMLX13.dtdDTD referenced from the XMI 1.0 test model. The DTD is required to process XMI 1.0 models in ShapeChange.
test/test.eapTest model in Enterprise Architect format.
test/testXMI.xmlShapeChange configuration for the XMI 1.0 test model that creates a GML 3.2 application schema and a HTML feature catalogue.
test/testEA.xmlShapeChange configuration for the Enterprise Architect test model that creates a GML 3.2 application schema and a HTML feature catalogue.
test/eaFolder for sample output created during testing with the Enterprise Architect test model. The contents of the directory is considered the reference result.
test/ea/log.xmlLog file written during processing the Enterprise Architect test model.
test/ea/test.htmlHTML feature catalogue derived from the Enterprise Architect test model. This file is identical to the one created from the XMI 1.o test model, except for the internal element identifiers.
test/ea/test.xsdGML 3.2 application schema derived from the Enterprise Architect test model. This file is identical to the one created from the XMI 1.o test model.
test/xmiFolder for sample output created during testing with the XMI 1.o test model. The contents of the directory is considered the reference result.
test/xmi/log.xmlLog file written during processing the XMI 1.o test model.
test/xmi/test.htmlHTML feature catalogue derived from the XMI 1.o test model. This file is identical to the one created from the Enterprise Architect test model, except for the internal element identifiers.
test/xmi/test.xsdGML 3.2 application schema derived from the XMI 1.o test model.  This file is identical to the one created from the Enterprise Architect test model.
xsltFolder for example XSLT stylesheets that may be used by ShapeChange targets, e.g. the feature catalogue generation.
xslt/docx.xslExample stylesheet to generate DOCX feature catalogues.
xslt/frameHtml.xslExample stylesheet to generate frame-based HTML feature catalogues.
xslt/html.xslExample stylesheet to generate (single-page) HTML feature catalogues.
xslt/localizationMessages.xmlExample XML file that contains a list of all messages required when creating a feature catalogue, in different languages. This file can be customized to support additional languages. (further details: here)"
xslt/stylesheet.cssExample cascading stylesheet that applies to frame-based HTML feature catalogues (further details: here)."