LCC XML Document - USEPA/ATtILA2 GitHub Wiki

ATtILA's LCC XML Document

ATtILA Land Cover Classification (LCC) schema documents require a precise XML structure that consists of the following:

Detailed descriptions, applications, and possible restrictions for each element are provided their respective sections in this document. The Supplied Land Cover Classification Schemas that accompany ATtILA may be useful to review while reading through the following sections. What may initially appear to be complex, hard to decipher documents will become easier to interpret with the background information provided below.

Basic structure of ATtILA's Land Cover Classification schema XML document: all required elements.

<?xml version='1.0' encoding='utf-8'?>
<lccSchema xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns="lcc" xsi:schemaLocation="lcc XSD_FILE_PATH">
	<metadata>
		<name></name>
		<description></description>
	</metadata>
	<coefficients>
		<coefficient Id="" Name="" fieldName="" method="" />
	</coefficients>
	<values>
		<value Id="" Name="" excluded="">
			<coefficient Id="" value="" />
		</value>
	</values>
	<classes>
		<class Id="" Name="" filter="">
			<value Id="" />
		</class>
	</classes>
</lccSchema>

It is recommended that users create or edit LCC schema XML documents using the Land Cover Classification Editor that accompanies ATtILA to reduce the possibility of introducing errors. However, LCC XML documents may also be created or edited using any standard text editor and the syntax guidelines provided in each section.

Regardless of how a user chooses to create their LCC XML documents, it is strongly recommended that they first become acquainted with the details on LCC XML formatting. This will give the user a better understanding of how ATtILA interacts with the land cover grid and will provide a background for understanding how ATtILA may be customized for user-specific needs.

XML Fundamentals

An XML document is composed of text content marked up with tags describing the data. These tags look similar to HTML mark-up tags, but unlike HTML, the tags are customized to define what an item is (i.e., a book, a person, a telephone number, etc.) and particular attributes of each defined item (i.e. the book's title, a person's first and last name, whether the telephone number is for a home, business, or mobile device, etc.). In order for an application to correctly parse an XML document into its various pieces, the XML document must be "well-formed"; in other words, it must follow certain rules.

When using the Land Cover Classification Editor in ATtILA to modify or create an LCC XML document, the resulting output document will be well-formed with regard to the ATtILA application. When editing the LCC XML document with a text editor, these general XML rules must be observed:

  • Each start-tag (<tag>) must have a matching end-tag. The end-tag can be either a non-empty element, (</tag>), or an empty element (/>).
  • Attribute values must be quoted.
  • Attribute names must be unique, and XML is case-sensitive: "name" is different from "Name" which is different from "NAME".
  • Comments and processing commands cannot appear inside tags.

When editing an LCC XML document with a text editor, it is important to check the document for formatting errors and, more importantly, for any violations to the rules and restrictions ATtILA places on document elements and attributes. The XML Validation section of this document provides instructions for performing these checks.

arrow_up Top of the page     |     arrow_left Land Cover Classification     |     arrow_right XML Declaration

⚠️ **GitHub.com Fallback** ⚠️