AiGIS is a 3D GIS designed for analysis on exploration data of irregular-shaped small bodies. The shape of a target body is represented by a polygon model, and geographic information is associated with polygons of the model. AiGIS can visualize and manipulate the shape model and map data on it.
The source code of AiGIS is under preparation to release.
Previous releases can be found here.
These data are distributed as a sample. DO NOT use them in your actual scientific research projects.
See below for a detailed description of the dataset for AiGIS.
Latitude-Longitude grid generator
How to use
Before start-up AiGIS, it convenient to set your local directory environment to AiGIS preference file (AiGIS.properties).
Location of AiGIS.properties
- Mac: AiGIS.app/Contents/MacOS/AiGIS.properties (Open from a right-click menu)
- Linux: app/AiGIS.properties
- Windows: app/AiGIS.properties
Items in AiGIS.properties
- defaultDataPath: Path to your AiGIS data
- savePngPath: Path to snapshot images taken in AiGIS
- defaultImageMapPath: Path to your images and image maps data
- NOTE to Windows users: Path delimiters should be doubled in the file.
- For example, your path to ‘C:\Users\CurrentUserName\AiGISData’ should be indicated ‘C:\\Users\\CurrentUserName\\AiGISData’
- Once starting-up, AiGIS ask you the place of your data directory
- Sample data are distributed from the same place you get AiGIS
- Data directory should contain a setting file AiGIS_setting.txt
- You can edit the file if you want to add or change your dataset
- Windows user may requested to install a VC++ library to run AiGIS
- AiGIS can load Shape model in Wavefront object format (.obj)
- Two different model files (low and high-res or two models to be compared) can be loaded
- If you have only a single model, you can use is as the low-res model (high-res model can be omitted). If you want to use the Multi-view mode, we recommend using a single model to avoid slowing down of operation.
- A line starting ‘#’ is treated as comments in Shape models, Map data, and Graph map data
- See below for Map data and Graph map data formats
- Rotate the asteroid by mouse operation
- with Shift key to move the light source direction
- with Option key or use wheel to zoom in and out
- with Control key to translating the asteroid
- Asteroid rotation and light source direction can be changed by using dialog in the main window
- Uncheck "View>Shading" to turn off direct lighting
- Better to use when you view a grayscale map data
- Select "View>Reset view" to reset the view to the initial state
Work with Map data
- Select a data to view in the Map data list
- Click on the model to extract values on the polygon (Clicked polygon will be colored with red)
- Values can be copied to your clipboard with the "Copy" button
- Rainbow and grayscale are available as look-up-tables (LUT) for Map data
- Select "View>Rescale Color Range" to change LUT-Map data value assignment
Work with Graph map data
- Select a map data associated with a graph map data
- NIRS_COUNT in the Itokawa sample data set is associated with NIRS Spectra data
- Click on the model to show a preview plot in the main window
- Click "Open the chart window" to show the plot in a large plot window
- Plots can be added to the plot window to repeat this operation
Image and Map image mapping
- Choose "Image>Open Image/Map Image…" to map an image with geometry information or a map image in the simple cylindrical projection.
- Images in general image formats (jpg, png...) can be loaded to AiGIS (Currently a FITS image is not acceptable).
- Geometry information should be provided in the INFO format used in Small Body Mapping Tool developed by APL/JHU.
NOTICE: From v20180717, memory handling in the multi-view mode is improved. Now you don’t worry about slowing-down of App with large shape models and map data.
NOTICE: Multi-view mode requires a certain amount of memories. We recommend using a data-set containing a single model to avoid slowing down of operation when using this mode (see Itokawa sample (low-resolution data for the Multi-view mode).
- Choose "Multi-View>Division" to enter the Multi-view mode.
- Uncheck "Sync Views" to stop synchronized operation to the models in the Multi-view mode
- Select "Sync All Views" to synchronize displays in the Multi-view mode
- Open…: Load another data set
- Save Snapshot: Save a snapshot of the main view in png format. The location of the saved images can be changed by modifying savePngPath setting in AiGIS.properties
- Show Lat-Lon Grid: Show and hide the latitude-longitude grid
- Show Color Bar: Show and hide the color bar for map data
- Show Additional 3D object: Show and hide additional 3D objects
- Rescale Color Range: Change LUT-Map data value assignment
- Look-up Table: Change LUT (Rainbow or Grayscale)
- Shading: Turn on/off direct lighting
- Reset view: Reset the view to the initial state
- Division: Enter the multi-view mode to choose 2 or 4, and end the mode to choose 1
- Sync Views: Uncheck to stop synchronized operation to the models in the Multi-view mode
- Sync All Views: Synchronize displays in the Multi-view mode
- Open Image/Map Image…: Open a dialogue to choose an image with geometry information or a map image in the simple cylindrical projection to map it on the shape model
- Show Image: Show and hide the mapped image
#Data Name (Appeared on the Map data list)
#Unit (or description)
#The Number of Polygons
#Polygon_ID Value (Tab and Space is allowed as delimiter)
#Continue for all polygones
Notes on Map data
- No duplicated Data Name is allowed for map data for a model
- Hyphen '-' can be used when no value is available on a certain polygon
- A line starting ‘#’ is treated as comments in Map data, Graph map data, and Shape models
Graph map data
Sample: nirs_spcmap_051116.txt (NIRS Spectra)
#Name of Map data that the graph map data is associated
#Unit (or description) for the X-axis
#Unit (or description) for the Y-axis
#The Number of Polygons
#_ Values for the X-axis (1st column should be '_') ...
_ 2247.88 2224.32 2200.76 2177.20 ...
#Polygon_ID Values for the X-axis ...
1 0.000000 0.000000 0.000000 0.000000 ...
#Continue for all polygones ...
2 0.000000 0.000000 0.000000 0.000000 ...
Notes on Graph Map data
- Lines starting ‘#’ are treated as comments in Graph map data, Map data, and Shape models
Data set structure
Minimum contents of the data set directory for AiGIS are as follows:
- Shapemodel directory
- MapData directory
- MapDataHigh directory
The Shapemodel directory is usually used to place shape models and gird data, but they can be placed outside this directory. Files in MapData and MapDataHigh directories are assumed and try to load as map data for the SHAPE and SHAPEHIGH models respectively.
Items in AiGIS_setting.txt
All items in AiGIS_setting.txt are described in KEY = VALUE style. Multiple VALUES may be assigned in the following format
KEY = VALUE1,VALUE2,VALUE3
- SHAPE (mandatory)
- Path to the low-resolution shape model in the relative path style from the directory placed AiGIS_setting.txt
- SHAPEHIGH (optional)
- Path to the high-resolution shape model.
- GRIDR/GRIDW (mandatory)
- Path to the latitude-longitude grid data. The same grid data will be applied both the low-resolution and high-resolution models. Because this items are mandatory, you may prepare dummy grids for shape models that grids are unavailable.
- CHANGEMODEL (optional)
- TRUE or FALSE to control automatic change of displayed model while model manipulation. The low-resolution model is displayed while model manipulation when CHANGEMODEL is TRUE even the high-resolution model is selected to be displayed.
- MAPDATA/MAPDATAHIGH (optional)
- Path to additional map data for the low-resolution model and high-resolution model not placed in MapData/MapDataHigh directories, respectively. Multiple values are accepted.
- CHARTDATA (optional)
- Path to graph map data. Error will be occurred when a graph map data doesn't have an associated map data
- GRID (optional, this keyword may be renamed in future)
- Path to directory containing data of additional 3D objects
- Improve multi-view mode with high-resolution shape models
- Rebuild user interfaces
- Fix several bugs
Please send your questions and comments to Naru Hirata (email@example.com) or our group mail address (firstname.lastname@example.org).
Hirata N. et al. (2018) AiGIS: A 3D-GIS for Visualization of Map and Shape of Irregular-Shaped Small Bodies, LPS XLIX, Abstract #1849.
Fujii Y. et al. (2007) Visualization Tool for 3D GIS Data, LPS XXXVIII, Abstract #1521.
Hirata N. et al. (2008) A GIS-Oriented Analysis Tool for Irregular Shaped Bodies, LPS XXXIX, Abstract #1584.
AiGIS was originally developed as a research project by students at the University of Aizu.
The project is supported by JSPS KAKENHI Grant Number 17K05639 and a collaborative research between JLPEDA/JAXA and the University of Aizu. Aizu Laboratory, Inc. supports development and maintenance of the software.