Skip to content

Latest commit

 

History

History
101 lines (70 loc) · 3.77 KB

README.md

File metadata and controls

101 lines (70 loc) · 3.77 KB

Cartography (cart) Discipline Dictionary

The Cartography discipline dictionary model describes map projections, including orbital-, lander-, and rings-related definitions and descriptions. The PDS Cartography dictionary is largely based on the existing Federal Geographic Data Committee (FGDC) Content Standard for Digital Geospatial Metadata, with modifications and extensions applied by PDS as needed for planetary mapping applications. This dictionary is strongly recommended for any map projected (derived) PDS4 products whether they are an image-based (e.g. Array_2D, Array_3D_Map, etc.) or GIS vector-based (table-based with defined point, line or polygon geometries). The Cartography and Imaging Sciences Node at both the U.S. Geological Survey (USGS) and Jet Propulsion Laboratories (JPL) are the stewards of this dictionary.

Steward: Trent Hare, Cartography and Imaging Sciences Node

Documentation

See this dictionary's online documentation at https://pds-data-dictionaries.github.io/ldd-cart for a User Guide and Detailed Documentation on this dictionary.

Latest Release

Using This Repository

In this repo you will find...

  • src - The managed IngestLDD file that defines this dictionary. This is where changes to the dictionary itself are made.
  • build - The generated schema files for this dictionary. The .xsd and .sch files can be found here, among other LDDTool output
  • test - The regression tests for this dictionary.
  • logs - Logs generated by the GitHub-automated build and test processes of LDDTool and Validate
  • examples - sample sections using this dictionary
  • .github - Internal files used to manage the automated build processes

Implement

See the tutorial on updating and building an IngestLDD and the LDD Update Process for more details.

Contribute

Propose Updates

See the LDD Update Process

Contribute

Have a bug or feature request? Create one in the PDS4 Issue Repo.

Support

See the PDS Data Dictionaries Support page for more Support information.

Notes

Each build is auto-generated using Github Actions, PDS4 LDDTool, and Validate Tool.

You can manually run LDDTool on the IngestLDD using the following command:

lddtool -lpsnJ MY_IngestLDD.xml

Generating Dictionary Documentation

This is auto-generated by Github Actions, but if you would like to generate on your laptop:

`. Install Python dependencies (preferable within a Python virtual environment)

pip install -r requirements

Generating HTML

  1. Make the docs
cd docs
make clean html
  1. Preview the html in your browser
open build/html/index.html

Generating PDF

  1. Install additional dependencies:

On a Mac:

brew install texlive

On Linux:

apt-get install texlive-latex-recommended texlive-latex-extra texlive-fonts-recommended 
  1. Make the PDF
cd docs
make latexpdf
  1. Preview the PDF
# filename will vary depending upon the project name specified in conf.py
open build/latex/cartographynamespace.pdf