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:

File Description
ShapeChange-X.Y.Z.jar The ShapeChange software packaged as a JAR file.
ShapeChange-X.Y.Z-sources.jar The ShapeChange source code.
LICENSE The license of this ShapeChange distribution - the GNU Public License v3.
lib Folder containing libraries needed by ShapeChange.
test Folder for resources to test the installation.
test/test.xmi Test model in XMI 1.0  format. This is a copy of https://shapechange.net/resources/test/test.xmi.
test/UMLX13.dtd DTD referenced from the XMI 1.0 test model. The DTD is required to process XMI 1.0 models in ShapeChange.
test/test.eap Test 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:

File Description
config Folder 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.xml This 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.xml This 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.xml Includes 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.xml Includes 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.xml Includes 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.xml Includes 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.xml Map 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.xml Map 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.xml Map entries for mapping types from the GMLCOV standard to their implementations.
config/StandardMapEntries_gsip.xml Map entries for basic types according to the GSIP encoding rule
config/StandardMapEntries_iso19107-v21.xml Map entries for mapping types from ISO 19107 (spatial schema) to their GML (2.1) implementations.
config/StandardMapEntries_iso19107-v31.xml Map entries for mapping types from ISO 19107 (spatial schema) to their GML (3.1) implementations.
config/StandardMapEntries_iso19107.xml Map 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.xml Map entries for mapping types from ISO 19108 (temporal schema) to their GML (3.1) implementations.
config/StandardMapEntries_iso19108.xml Map 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.xml Map entries for mapping types from ISO 19111 (coordinate reference systems) to their GML (3.1) implementations.
config/StandardMapEntries_iso19111.xml Map entries for mapping types from ISO 19111 (coordinate reference systems) to their GML (3.2 and above) implementations.
config/StandardMapEntries_iso19115-v21.xml Map entries for mapping types from ISO 19115 (metadata) to their GML (2.1) implementations.
config/StandardMapEntries_iso19115.xml Map entries for mapping types from ISO 19115 (metadata) to their ISO/TS 19139 implementations.
config/StandardMapEntries_iso19123-v31.xml Map entries for mapping types from ISO 19123 (coverages) to their GML (3.1) implementations.
config/StandardMapEntries_iso19123.xml Map entries for mapping types from ISO 19123 (coverages) to their GMLCOV implementations.
config/StandardMapEntries_iso19136_2007.xml Map entries for basic types according to the GML 3.2 / ISO 19136 encoding rule.
config/StandardMapEntries_iso19139_2007.xml Map entries for basic types according to the ISO/TS 19139 encoding rule.
config/StandardMapEntries_iso19156.xml Map entries for mapping types from ISO 19158 (observation and measurements) to their OMXML implementations.
config/StandardMapEntries_sweCommon.xml Includes 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.xml Lists 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.xml Lists 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.xml Lists 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.xml Specifies 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.
dist Folder for the ShapeChange distribution files (JAR and ZIP archives).
example Folder for examples.
schema Folder for XML Schema documents
schema/ShapeChangeConfiguration.xsd XML Schema for ShapeChange configuration files.
schema/ShapeChangeAppinfo.xsd XML Schema for elements embedded by ShapeChange in appinfo annotations.
schema/ShapeChangeResult.xsd XML Schema for the log files created by ShapeChange.
schema/w3c/XInclude.xsd XML Schema for XInclude published by W3C.
templates Folder for template files used by ShapeChange.
templates/template.docx Template file that can be used to create a feature catalogue output of an application schema in DOCX format."
test Folder for resources to test a ShapeChange installation.
test/test.xmi Test model in XMI 1.0  format.
test/UMLX13.dtd DTD referenced from the XMI 1.0 test model. The DTD is required to process XMI 1.0 models in ShapeChange.
test/test.eap Test model in Enterprise Architect format.
test/testXMI.xml ShapeChange configuration for the XMI 1.0 test model that creates a GML 3.2 application schema and a HTML feature catalogue.
test/testEA.xml ShapeChange configuration for the Enterprise Architect test model that creates a GML 3.2 application schema and a HTML feature catalogue.
test/ea Folder 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.xml Log file written during processing the Enterprise Architect test model.
test/ea/test.html HTML 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.xsd GML 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/xmi Folder 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.xml Log file written during processing the XMI 1.o test model.
test/xmi/test.html HTML 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.xsd GML 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.
xslt Folder for example XSLT stylesheets that may be used by ShapeChange targets, e.g. the feature catalogue generation.
xslt/docx.xsl Example stylesheet to generate DOCX feature catalogues.
xslt/frameHtml.xsl Example stylesheet to generate frame-based HTML feature catalogues.
xslt/html.xsl Example stylesheet to generate (single-page) HTML feature catalogues.
xslt/localizationMessages.xml Example 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.css Example cascading stylesheet that applies to frame-based HTML feature catalogues (further details: here)."