|
My World Documentation
1. Title Page
2. What is My World?
3. Construct Mode
4. Visualize Mode
5. Edit Appearance Window
6. Layer Information Window
7. Analyze Mode
8. Selections
9. Edit Mode
10. Editing Data Libraries
11. File Types
12. Importing Data
13. How My World Finds Data
14. The Menu Bar
15. Glossary
16. FAQ
17. Release Notes
18. Known Issues
19. Acknowledgments
20. Contacting Us
|
11. File Types
Shape Data File Types
My World supports the following types of data files and/or folders for
reading and writing shape data:
-
ESRI Shapefile:, a set of three files
with the same name and the file extensions ".dbf", ".shp", and ".shx"
respectively. All three files are required. Other files, such as ".prj"
files, may be present, but My World doesn't require or use them.
The shapefile must contain unprojected latitude and longitude values, in
decimal degrees, in the range -180 to 180. My World can automatically
un-project shapefiles as they are imported, but you
must know the original projection for this to work. Import the data
using the "Import Data From File..." button or menu item to access the
un-projection tool.
My World supports Point, Arc (line), Polygon and MultiPoint shapefiles.
-
Comma-Separated Values: a single text file
with the extension ".csv", and comma (",") characters separating each
value. The first row of the file should list the field names, and the
first two columns must be latitude and longitude, respectively, in
decimal degrees, in the range -180 to 180. When you import a CSV file,
My World will give you the opportunity to re-arrange the columns so that
latitude and longitude are in the proper place.
My World uses the same CSV format as Microsoft Excel. If you want a comma
character to appear inside a cell value, the entire cell value must be
enclosed in double quotes ("). To include a double-quote character inside
a quoted value, use two double quotes in a row ("").
CSV files can only contain Point data.
-
Tab-Separated Values: a single text file with
the extension ".tsv". Other requirements are the same as for
comma-separated files, except that tab (" ") characters separate the
values instead of comma characters.
If you want a tab character to appear inside a cell value, the entire cell
value must be enclosed in double quotes ("). To include a double-quote
character inside a quoted value, use two double quotes in a row ("").
TSV files can only contain Point data.
-
GPX Waypoint File: a single xml file with
the extension ".gpx". This file is used for importing GPS data into My
World. If you need to import data from a GPS device not supported by
My World's built-in GPS importing functionality, the easiest way to
accomplish it is to save the data in GPX format.
My World can read GPX files, but it does not support saving data in GPX format.
Click here for more information about the GPX file format.
Grid Data File Types
My World supports the following types of data files and/or folders for
reading and writing grid data:
-
ASCII Grid file: a single file with the extension
".asc". Click here
for a complete description of the ASCII Grid file format.
-
Folder of ASCII Grid files: a folder whose name
ends with ".asc", containing a set of ASCII Grid files (whose names must
also have the extension ".asc"). The files will be listed as fields of the
layer, in alphabetical order by file name.
By default, the origin, cell size, and dimensions of the grid will be those of
the file whose name is first alphabetically. Those settings can subsequently be
adjusted in the Edit Layer Appearance window.
-
NetCDF file: a single file with the extension
".nc". My World only supports NetCDF files that use the
Unidata Common Data Model. Also, My World can only read NetCDF files, it
cannot currently write data in NetCDF format.
-
WorldWatcher Grid file: a single file with
the extension ".wwf". WorldWatcher
is a GIS that only handles grid data. It was the predecessor to My World GIS.
-
Folder of WorldWatcher files: a folder whose
name ends with ".wwf", containing any number of WorldWatcher files (whose names
must also have the extension ".wwf"). The files will be listed as fields of the
layer, in alphabetical order by file name.
By default, the origin, cell size, and dimensions of the grid will be those of
the file whose name is first alphabetically. Those settings can subsequently be
adjusted in the Edit Layer Appearance window.
ASCII Grid files can be very memory-intensive, so it's better to save your data in
WorldWatcher format once you have imported it into My World.
Image Data File Types
My World supports the following types of data files and/or folders for
reading and writing image data:
-
JPEG image: a set of two files with the same
name and the file extensions "jpg" and "jgw".
The "jpg" file contains the image, and the "jgw" file is called the
World File, and contains information about where
on the map the image should be displayed.
-
TIFF image: a set of two files with the same
name and the file extensions "tif" or "tiff" and "tfw". The "tif"/"tiff"
file contains the image, and the "tfw" file is called the
World File, and contains information about where on the map the image
should be displayed.
My World can only read 1-band and 3-band TIFF files.
-
GeoTIFF image: a single file with the extension
"tif" or "tiff".
Unfortunately, it's often impossible to distinguish GeoTIFF files
from regular TIFF files without using a program to open them. Sometimes, a
GeoTIFF will have ".geo." in its name, before the file extension, but not
always.
If a "tfw" file is available, the file is probably a regular TIFF,
and if not, then nothing is harmed by putting a "tfw" file with a GeoTIFF, so
always keep the "tfw" file with the "tif" file if one is available.
My World can only read 1-band and 3-band GeoTIFF files.
Links to Dynamic Web Data
Using a dynamic web layer requires a working internet connection, on which
port 80 (the port used for World Wide Web traffic) is not blocked.
-
WMS link: a single file with the extension
"wms_xml". The file does not contain any data itself, just the address
of a server that uses the
Web Mapping Service (WMS) to dynamically provide images to My World.
-
THREDDS link: a single file with the extension
"thl". The file does not contain any data itself, just a link to a
THREDDS Server, which may provide either shape data or grid data.
THREDDS stands for
Thematic Realtime Environmental Distributed Data Services and is
a project of Unidata,
a community of over 160 institutions vested in the common goal of sharing
data, and tools to access and visualize that data, to support Earth-system
education and research.
-
ArcIMS link: a single file with the extension
"aims_lnk". The file does not contain any data itself, just a link to an
ArcIMS Server, which may provide either shape data or dynamic image data.
ArcIMS Server is a commercial product produced by ESRI, and "ArcIMS"
is a registered trademark of ESRI, Inc.
The ability to connect to an ArcIMS server is only present in registered
copies of My World licensed for educational use.
Annotation File Types
My World supports the following types of data files and/or folders for
reading and writing annotations:
Additional Layer Files
In addition to the data files specific to the particular file type, My World
will add two new files when it saves a layer. Both of these files will have
the same name as the layer's data file(s), but a different file extension.
-
The Layer File ends with the extension ".myl"
and contains information about how by My World should display the
data file, such as default appearance settings for each field, and
information about each field, such as its category and units.
If you lose or delete the Layer File, My World will still be able to read the
data file, but any appearance settings you might have customized will be re-set
to their default values.
-
The Data Documentation file is a text file (.txt)
file which contains information about where the data came from, who owns it,
and where to look for more information about it.
Project Files
My World can save two different types of Project files.
-
Project Folder (.m3vf): is a folder whose name ends
in ".m3vf", containing all of the project's data files, included files, linked
files, and all of its appearance settings.
-
Compressed Project File (.m3vz): is a single file,
containing a m3vf folder that has been compressed using ZIP compression. You can
examine the contents of an m3vz file by opening it using a program that can read
ZIP files, such as WinZip.
While you are working on a project, it is best to save it as a m3vf folder, because
reading and writing to the folder is faster, since it doesn't involve compressing the
data.
If you want to share your project with someone using another computer, you should save
it as an m3vz file, because the file will be smaller and it's easier to copy a single
file from one computer to another than a whole folder full of files.
If you are downloading an m3vz file and your web browser unzips it without asking you
(as Safari sometimes does, unfortunately), you can simply add ".m3vf" to the end of the
name of the resulting folder and open it as a project folder in My World.
Tour Files
A tour is an HTML file that has been specially formatted for My World, to break it up
into individual screens -- usually corresponding to steps the user should take as he
or she navigates through the tour. Tour file names must end with the extension ".mwht".
In addition to standard HTML (including styles, but not CSS), My World tour files support
several additional tags:
-
<!--break--> indicates where the break between one tour section
and the next should occur.
This tag may occur any number of times, but only between the <body>
and </body> tags of the document.
-
<!--size: [number] [number]--> indicates the preferred window size
for this tour.
This should occur only once, between the <head> and
</head> tags of the document.
In addition to these special tags, My World also supports several special hypertext
references you can use in your anchor tags in a tour document:
-
#project the link will cause the My World window to switch to Construct
Mode, and select the "All Projects" Data Library from the Library menu.
Example: <a href="#project">Open Projects Library</a>
-
#welcome will close the current tour and re-open the Welcome Window.
Example: <a href="#welcome">Return To Welcome Window</a>
To see more examples of what a tour file should look like, take a look at the files
in My World's tours folder.
|