Survey
* Your assessment is very important for improving the workof artificial intelligence, which forms the content of this project
* Your assessment is very important for improving the workof artificial intelligence, which forms the content of this project
Cartogram Utility for ArcGIS FACT SHEET: Size in Megabytes (MB): Software: Application/Extension: Database: Platforms Tested: Special Functionality: Audience: 45 ArcInfo 9.2, ArcEditor 9.2, ArcView 9.2 ArcMap, ArcCatalog GeoDatabase (ArcSDE, Personal and File Based outputs) and Shapefiles (as inputs only) Windows XP, Windows 2000 Cartograms General Audience PURPOSE: This Geoprocessing utility permits the production of cartograms from Geodatabases or shapefiles. The output must be written to Geodatabases. Cartograms substitute the value of another variable in place of area for map regions, for example total population or in the case of the graphic below, total CO2 missions. The utility is deployed as a Geoprocessing tool that creates Density Equalizing Cartograms using the methodology developed by Mark Newman and Michael Gastner at the University of Michigan (Michael T. Gastner and M. E. J. Newman, "Diffusion-based method for producing densityequalizing maps", Proceedings of the NAS, May 18, 2004, vol. 101, no. 20, pp 7499-7504). Density Equalizing Cartograms change the shape of map polygons so that their size is based upon another attribute such as population. The size and shape of the polygons are changed, sometimes dramatically, but their original neighbors remain neighbors, and no new neighbors or new gaps are added. This utility also provides the capability to modify the location and or shape of associated point, line and raster documents, saving their transformed output into the same Geodatabase as that of the cartogram. Copyright © 2007 Environmental Systems Research Institute Inc. (ESRI ®). 1 A sample dataset is included. DATA SOURCES AND DESCRIPTION: (Refer to Data Distribution Permission statement at the end of this document) For this demo a personal Geodatabase is provided. It contains: Cities A reference file of the 48 largest cities on the planet. Detailed source information is provided in the file metadata. Countries_2007 A polygonal reference file of 249 country and sovereign areas. The data include Current Population and forecasts, GDP, Imports, Export, Carbon Dioxide Emissions, and HIV/AID infection and fatality counts. Source: Population Values and forecasts Unless otherwise noted, US Census Bureau, International Division, www.census.gov/ipc/www/. Source: GDP, Imports, Exports, AIDS Deaths, AIDS/HIV numbers Unless otherwise noted, the data are from the CIA Factbook 2007 (www.cia.gov/cia/publications/factbook). Most data were drawn from the online publication's rank ordered tables (updated February and March 2007). Data definitions likewise, unless otherwise noted, are taken directly from the "Notes and Definitions" section of CIA Factbook 2007. Source: Total Carbon Dioxide Emissions U.S. Energy Information Agency, International Energy Annual – 2004. Geographic note on China: The data presented for China do not include Hong Kong, Macau, and Taiwan. Detailed source information is provided in the file metadata. Copyright © 2007 Environmental Systems Research Institute Inc. (ESRI ®). 2 Degree30_polys A graticule with a 30 degree mesh size. Detailed source, processing and distribution information are provided in the file metadata. NasaBM8km An image file derived from the NASA’s Blue Marble, Earth Observatory project. The file has a cell resolution of 8 km. Detailed source, processing and distribution information are provided in the file metadata. CONTENTS: • • • • BnchMrkCartogram.dll – Contains the Component Object Model (COM) component that does the cartogram transformation and makes the new Feature Classes. BnchMrkGPCartogram.dll – Contains the Geoprocessing Tool that provides the interface for using the COM component in BnchMrkCartogram.dll. Cartogram_Toolbox.xml – The help file used by the Geoprocessing Tool. Cartogram.tbx – A Toolbox containing the Cartogram tool. INSTALLATION: The default location for this utility is <install drive>:\ArcScripts\Cartograms. The utility is packaged as a small demo application; however it is intended to be used independently of the demo and data provided. The installation of this demo will create an entry in the Programs Menu. The demo can be accessed from Start | Programs | Cartograms, or by browsing to the installation location (install_dir = <install_path>\ArcScripts\Cartograms) in Windows Explorer. To uninstall the demo, use the Windows Add/Remove Programs functionality to remove ArcScripts Cartograms. TO RUN THIS UTILITY: Use the entry in the Programs Menu Start | Programs |Cartograms | Start Demo, or start the demo by double clicking the Cartogram.mxd file in the installation folder. DEMO SCRIPT: Add the ArcToolbox from the ArcMap (or ArcCatalog) menu line if it is not already open. Organize the content of your map display and toolbars to be similar to the illustration below. Copyright © 2007 Environmental Systems Research Institute Inc. (ESRI ®). 3 Note: The Cartogram.mxd was saved with the Cartogram toolbox already loaded. If you want to use the Cartogram tool in a different .mxd you will need to add the Cartogram toolbox from <install drive>:\ArcScripts\Cartograms. To do this, right-click on the ArcToolbox entry and select Add Toolbox.... Navigate to <install drive>:\ArcScripts\Cartograms, select the Cartogram toolbox and click Open. You are now ready to use the Cartogram geoprocessing utility. Copyright © 2007 Environmental Systems Research Institute Inc. (ESRI ®). 4 Check your data! Before you proceed however, you’ll need to inspect your data. The cartogram utility requires that the values being used to generate the cartogram are positive numbers. Null values are ignored, but negative values such as those associated typically with No Data values (i.e. -99) will cause a warning message to be display. The simplest approach is to either use a definition query to avoid negative values in your dataset or else create a new layer file after applying a selection for values >= 0. Right click on the Countries_2007 layer in the Table of Contents and select Properties… Select the Definition Query tab, and use the query tool to build the following query, and press the OK button at the bottom of the form. Return to the Toolbox and double click on the Create a cartogram tool. Rather than document all the options of the tool, the user is encouraged to click on each input or scroll down box to read the corresponding help. Copyright © 2007 Environmental Systems Research Institute Inc. (ESRI ®). 5 Use of the Copy the Original Polygon Features table to the Output Cartogram Features table is highly recommended. This enables you to perform bivariate mapping quite easily. Likewise the use of the optional Additional Features/Rasters to Transform list is very useful for transforming and adding additional feature and raster data to provide visual reference. Items to keep in mind when using this utility: 1) Cartograms must be generated from positive numeric attribute values. 2) All results must be written to a Geodatabase, even though inputs may be shapefiles. 3) Candidate “Additional Features/Rasters to Transform” layers must have the same spatial reference as the source cartogram data, and the results of their transformation are all added to the same output Geodatabase as the transformed source data. Note: The ArcMap Data Frame properties can be set to a different projection. The spatial references of the source layers are preserved in the outputs. 4) The features created from the “Additional Features/Rasters to Transform” list must be manually added to the map display. The Cartogram Geoprocessing utility may also be used directly within ArcCatalog. Copyright © 2007 Environmental Systems Research Institute Inc. (ESRI ®). 6 DATA DISTRIBUTION PERMISSION: The data are provided by ESRI for non-commercial purposes including but not limited to personal use, presentations, demonstrations, teaching, classroom use, scholarship, and/or research. The data are freely reproducible and distributable with proper documentation and source attribution for the above purposes – refer to each file’s metadata. Uses of a commercial nature, such as but not limited to inclusion in or promotion or redistribution through other software packages that are sold, require licensing from ESRI. Countries_2007 Population, AIDS/HIV, CO2 Emissions, GDP, Import and Export Data about Countries, 2007 ESRI Inc. Redlands, CA Copyright © 2007 Overview: This geographic data file presents polygon data for 249 "countries" (sovereign nations, dependencies, and other global areas) covering: population; AIDS/HIV incidence and deaths; national Carbon Dioxide emissions values for 2004; Gross Domestic Product; and national Imports and Exports data. Population forecasts are provided for 2015 and 2025. Other data represent values collected between 1999 and 2007. A value of -99 is used to indicate No Data. Projection: Geographic Units: Decimal Degree Scale: This data file is best used at scales of 1:15,000,000 or greater. Source: Population Values and forecasts Unless otherwise noted, US Census Bureau, International Division, www.census.gov/ipc/www/. Source: GDP, Imports, Exports, AIDS Deaths, AIDS/HIV numbers Unless otherwise noted, the data are from the CIA Factbook 2007 (www.cia.gov/cia/publications/factbook). Most data were drawn from the online publication’s rank ordered tables (updated February and March 2007). Data definitions likewise, unless otherwise noted, are taken directly from the “Notes and Definitions” section of CIA Factbook 2007. Source: Total Carbon Dioxide Emmissions U.S. Energy Information Agency, International Energy Annual – 2004 Geographic note on China: The data presented for China do not include Hong Kong, Macau, and Taiwan. Where appropriate, data for these areas are included in the field name and data definitions below. Field Names: 1. OBJECTID 2. SHAPE 3. FIPS _CNTRY Feature ID code. Describes vector shape as point, line, or polygon. Two-letter code for the country or geographic entity. Source: US Department of Commerce, National Institute of Standards and Technology. Copyright © 2007 Environmental Systems Research Institute Inc. (ESRI ®). 7 4. GMI_CNTRY 5. ISO_2DIGIT 6. ISO_3DIGIT 7. ISO_NUM 8. 9. 10. CNTRY_NAME LONG_NAME ISOSHRTNAM 11. 12. 13. 14. UNSHRTNAM LOCSHRTNAM LOCLNGNAM STATUS 15. SQKM 16. SQMI 17. 18. 19. 20. 21. POP2007 POP2015 POP2025 POP014_07 POP1564_07 22. HIVAIDSTOT 23. 24. HIVAIDS_YR HIVDTH 25. 26. HIVDTH_YR TOTCO2_2004 27. GDP_USD Three letter code for the country or geographic entity from Global Mapping International. Two letter code for the country or geographic entity from the International Organization for Standardization. Three letter code for the country or geographic entity from the International Organization for Standardization. Three number code for the country or geographic entity from the International Organization for Standardization. Country name in common use. Official country name. Short name used by the International Organization for Standardization. Short name alias used by the United Nations. Short name used locally. Long name used locally. Official status as of 2007 including, UN member states, various territorial and dependency categories, and unique entities such as Antarctica. Area in square kilometers using an equal area projection. Source: ESRI. Area in square miles using an equal area projection. Source: ESRI. 2007 midyear population estimate. 2015 midyear population projection. 2025 midyear population projection. Population age 0-14, 2007 Population age 15-64, 2007 (Generally seen as the working age population) Number of people (adults and children) living with HIV/AIDS. Source: CIA Factbook, 2007 Year of estimate for HIV/AIDS population. Number of people (adults and children) who died of AIDS. Source: CIA Factbook, 2007 Year of estimate for AIDS deaths. Million Metric Tonnes of Carbon Dioxide Emissions. Source: U.S. Energy Information Agency, International Energy Annual - 2004. Values for Montenegro and Serbia are derived as proportions of combined EIA values for the former state, Serbia Montenegro using 2007 CIA Factbook values for Oil Consumption, by each country. Gross Domestic Product (GDP) (purchasing power parity) in US dollars. This is the value of all final goods and services produced within a nation in a given year. A nation's GDP at purchasing power parity (PPP) exchange rates is the sum value of all goods and services produced in the country valued at prices prevailing in the United States. This is the measure most economists prefer when looking at per-capita welfare and when comparing living conditions or use of resources across countries. The measure is difficult to compute, as a US dollar value has to be assigned to all goods and services in the country regardless of whether these goods and services have a direct equivalent in the United States (for example, the value of an ox-cart or non-US military equipment); as a result, PPP estimates for some countries are based on a small and sometimes different set of goods and services. In addition, many countries do not formally participate in the World Bank's PPP project that calculates these measures, Copyright © 2007 Environmental Systems Research Institute Inc. (ESRI ®). 8 28. 29. GDP_YR IMPORT_USD 30. 31. IMPORT_YR EXPORT_USD 32. EXPORT_YR so the resulting GDP estimates for these countries may lack precision. For many developing countries, PPP-based GDP measures are multiples of the official exchange rate (OER) measure. The difference between the OER- and PPPdenominated GDP values for most of the wealthy industrialized countries is generally much smaller. Year of estimate for GDP (purchasing power parity). Total merchandise imports in US dollars (on a c.i.f. [cost, insurance, and freight] or f.o.b. [free on board] basis). These figures are calculated on an exchange rate basis, i.e., not in purchasing power parity (PPP) terms. Year of estimate of import valuation. Total merchandise exports in US dollars (on a c.i.f. [cost, insurance, and freight] or f.o.b. [free on board] basis). These figures are calculated on an exchange rate basis, i.e., not in purchasing power parity (PPP) terms. Year of estimate of export valuation. Creation Date: March-Nov. 2007. Creator: ESRI Copyright 1995-2007 ESRI. All rights reserved under the copyright laws of the United States. You may freely redistribute and use this sample code, with or without modification. The sample code is provided without any technical support or updates. Disclaimer OF Warranty: THE SAMPLE CODE IS PROVIDED "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING THE IMPLIED WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, OR NONINFRINGEMENT ARE DISCLAIMED. IN NO EVENT SHALL ESRI OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) SUSTAINED BY YOU OR A THIRD PARTY, HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT ARISING IN ANY WAY OUT OF THE USE OF THIS SAMPLE CODE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. THESE LIMITATIONS SHALL APPLY NOTWITHSTANDING ANY FAILURE OF ESSENTIAL PURPOSE OF ANY LIMITED REMEDY. For additional information contact: Environmental Systems Research Institute, Inc. Attn: Contracts Dept. 380 New York Street Redlands, California, U.S.A. 92373 Email: [email protected] Copyright © 2007 Environmental Systems Research Institute Inc. (ESRI ®). 9