"Fossies" - the Fresh Open Source Software Archive  

Source code changes of the file "README.md" between
dcw-gmt-2.0.0.tar.gz and dcw-gmt-2.0.1.tar.gz

About: Digital Chart of the World polygon data (requires GMT 6.1.1 or later)

README.md  (dcw-gmt-2.0.0):README.md  (dcw-gmt-2.0.1)
# DCW-GMT: The Digital Chart of the World for GMT # DCW-GMT: The Digital Chart of the World for GMT
![GitHub release (latest by date)](https://img.shields.io/github/v/release/Gener icMappingTools/dcw-gmt) ![GitHub release (latest by date)](https://img.shields.io/github/v/release/Gener icMappingTools/dcw-gmt)
![GitHub](https://img.shields.io/github/license/GenericMappingTools/dcw-gmt) ![GitHub](https://img.shields.io/github/license/GenericMappingTools/dcw-gmt)
This repository contains the data and scripts that maintain and build This repository contains the data and scripts that maintain and build
the dcw-gmt package used by **GMT 5 or later**. **Note**: DCW 2.0.0 the dcw-gmt package used by **GMT 5 or later**. **Note**: DCW 2.0.0
requires GMT 6.1.1 or later. requires GMT 6.1.1 or later.
This README contains the documentation for DCW. For information about building
and modifying DCW, please refer to the [contributing guide](CONTRIBUTING.md).
![Global map of the DCW-GMT polygons](https://docs.generic-mapping-tools.org/6.2
/_images/dcw-figure.png)
## About ## About
The Digital Chart of the World is a comprehensive 1:1,000,000 scale The Digital Chart of the World is a comprehensive 1:1,000,000 scale
vector basemap of the world. The charts were designed to meet the needs vector basemap of the world. The charts were designed to meet the needs
of pilots and air crews in medium- and low-altitude en route navigation of pilots and air crews in medium- and low-altitude en route navigation
and to support military operational planning, intelligence briefings, and to support military operational planning, intelligence briefings,
and other needs. For basic background information about DCW, see the and other needs. For basic background information about DCW, see the
[Wikipedia entry](http://en.wikipedia.org/wiki/Digital_Chart_of_the_World). [Wikipedia entry](http://en.wikipedia.org/wiki/Digital_Chart_of_the_World).
The raw files used to build `dcw-gmt.nc` came from the Princeton University
Digital Map and Geospatial Information Center, accessible via website DCW-GMT is an enhancement to DCW in a few ways:
http://www.princeton.edu/~geolib/gis/dcw.html; however, the DCW access
seems to have disappeared. Other sites with DCW data include the GeoCommunity 1. It contains more state boundaries (the largest 8 countries are now represente
at http://data.geocomm.com/readme/dcw/dcw.html. d).
2. The data have been reformatted to save space and are distributed as a single
The dcw-gmt version has converted the (at present) 523 individual deflated netCDF-4 file.
polygon files to a single netCDF-4 file and compressed the data by
using rescaled short integer positioning. Note that many of these,
especially state boundaries for China, Russia, India, Argentina were
not in the original DCW but have been added later from other sources,
such as from http://www.gadm.org.
## Download ## Download
You can download the latest dcw-gmt package from You can download the latest dcw-gmt package from
[GitHub releases](https://github.com/GenericMappingTools/dcw-gmt/releases) [GitHub releases](https://github.com/GenericMappingTools/dcw-gmt/releases)
or from the [GMT main site](https://www.generic-mapping-tools.org/download/). or from the [GMT main site](https://www.generic-mapping-tools.org/download/).
## Usage ## Usage
If you are building GMT from source then you should set the parameter DCW-GMT is an optional install for GMT and its wrappers. If you did install it
**DCW_ROOT** in the *cmake/ConfigUser.cmake* to point to the directory where then you can access the DCW data for plotting or analysis via GMT's
dcw-gmt.nc has been placed. If you add this file later you can always [coast](https://docs.generic-mapping-tools.org/latest/coast.html) module. You
place it in your user **~/.gmt** directory or set the **DIR_DCW** parameter can also use the [ISO 2-character codes](https://en.wikipedia.org/wiki/ISO_3166-
in your *gmt.conf* settings. 1_alpha-2)
for countries as a way to specify map domains via the **-R** option. For
Refer to the [GMT documentation](https://docs.generic-mapping-tools.org/latest/d instance, to make a map showing France with a region rounded to the nearest 2
atasets/dcw.html) for more details about how to use the data in GMT. degrees in longitude and latitude, you can run:
## Changelog
The detailed changelog is available [here](ChangeLog).
## Building DCW-GMT
The original data in ASCII format are stored in the `orig` directory.
To build the `dcw-gmt.nc` file from the DCW data, you need to first edit the
configuration file [config.mk](config.mk), then run:
make build-dcw # Make the dcw-gmt.nc netCDF file gmt coast -RFR+r2 -Glightgray -B -pdf france
make archive # Create tarball and zipfile of DCW for GMT distr
ibution
make checksum # Compute MD5 checksum for the tarball
When done, clean out the directory with `make spotless`. If in addition you want to paint the landmass of France blue, you can run:
## Adding new country or state boundaries gmt coast -RFR+r2 -Glightgray -B -EFR+gblue -pdf france
To add new countries: To access states without countries you must use the *country.state* syntax. See
the [coast](https://docs.generic-mapping-tools.org/latest/coast.html)
documentation for details. For instance, to make a map of the US and show Texas
and Mississippi as red states, try:
1. obtain ascii data gmt coast -RUS+r2 -Glightgray -B -EUS.TX,US.MS+gred -pdf us
2. determine [ISO 2-char country code](https://en.wikipedia.org/wiki/ISO_3166-1_
alpha-2) *XX*
and name file *XX.txt*
3. determine which continent *ZZ* it belongs to and place in *ZZ* directory
4. add new entry in `dcw-countries.txt` in alphabetical position on *XX*
To add new state boundaries ## Notes
1. obtain ascii data If you are building GMT from source then you should set the parameter
2. determine [ISO 2-char country code]((https://en.wikipedia.org/wiki/ISO_3166-1 **DCW_ROOT** in the *cmake/ConfigUser.cmake* to point to the directory where
_alpha-2)) *XX* *dcw-gmt.nc* has been placed. If you add this file after GMT installation
and [state code](https://en.wikipedia.org/wiki/ISO_3166-2) *YY* and name file was completed then you can always have GMT find it by placing it in your
*YY.txt* user *~/.gmt* directory or by setting the **DIR_DCW** parameter in the
3. determine which continent *ZZ* it belongs to and place in *ZZ/YY* directory *gmt.conf* settings.
4. add new entry in `dcw-states.txt` in alphabetical position on *XX*, then *YY*
To remove countries or states: ## Changelog
1. remove the data file The detailed changelog is available [here](ChangeLog).
2. remove the corresponding entry in `dcw-countries.txt` or `dcw-states.txt`
## License ## License
The project is distributed under the The project is distributed under the
[GNU Lesser General Public License](http://www.gnu.org/licenses/lgpl-3.0.html). [GNU Lesser General Public License](http://www.gnu.org/licenses/lgpl-3.0.html).
 End of changes. 12 change blocks. 
55 lines changed or deleted 38 lines changed or added

Home  |  About  |  Features  |  All  |  Newest  |  Dox  |  Diffs  |  RSS Feeds  |  Screenshots  |  Comments  |  Imprint  |  Privacy  |  HTTP(S)