aigis:top
Differences
This shows you the differences between two versions of the page.
Both sides previous revisionPrevious revisionNext revision | Previous revision | ||
aigis:top [2023/01/15 18:58] – [Latest release] Naru Hirata | aigis:top [2024/10/09 18:39] (current) – [Acknowledgements] Naru Hirata | ||
---|---|---|---|
Line 6: | Line 6: | ||
AiGIS is a 3D GIS designed for analysis on exploration data of irregular-shaped small bodies. | AiGIS is a 3D GIS designed for analysis on exploration data of irregular-shaped small bodies. | ||
- | < | + | ==== |
- | ## Download | + | === |
- | ### Latest release | + | |
- | </ | + | |
< | < | ||
<ul> | <ul> | ||
- | <li>Release | + | < |
<ul> | <ul> | ||
- | < | + | < |
- | onClick=" | + | onClick=" |
- | aigis_20200325_mac.zip | + | AiGIS_v20231117_mac.zip |
</a> | </a> | ||
- | < | + | < |
- | onClick=" | + | onClick=" |
- | aigis_20200325_linux.zip | + | AiGIS_v20231117_linux.zip |
</a> | </a> | ||
- | < | + | < |
- | onClick=" | + | onClick=" |
- | aigis_20200325_win.zip | + | AiGIS_v20231117_win.zip |
</a> | </a> | ||
- | < | + | < |
- | onClick=" | + | onClick=" |
- | aigis_20200325_jar.zip | + | AiGIS_v20231117_jar.zip |
</a> | </a> | ||
</ul> | </ul> | ||
Line 35: | Line 33: | ||
Please contact us to obtain the source code. | Please contact us to obtain the source code. | ||
- | < | ||
- | #### Release note: 2020/03/25 | ||
- | * Support orthographic projection | ||
- | * Support independent control of FOV and distance for zoom level change | ||
- | * Improved operability of the 3D model at high zoom levels | ||
- | * enhanced support of user-defined 3D objects | ||
- | * Special note for macOS users: This release has not yet been notarized by Apple, but will work on the latest macOS environment including macOS 10.15 Catalina and macOS 11 Big Sur. We plan to release a notarized version at the next release. If you have any problem with this version, please contact us. | ||
+ | === Release note: 2023/11/17 === | ||
- | ### Previous releases | + | * Support multiple |
- | Previous releases can be found [here](aigis: | + | * Support macOS Ventura and Sonoma |
- | ### Sample data | + | ==== Previous releases ==== |
- | </ | + | |
+ | Previous releases can be found [[aigis: | ||
+ | |||
+ | ==== Sample data ==== | ||
< | < | ||
<ul> | <ul> | ||
< | < | ||
- | onClick=" | + | onClick=" |
Ryugu sample</ | Ryugu sample</ | ||
+ | < | ||
+ | onClick=" | ||
+ | Itokawa multi-models sample (for v20231117)</ | ||
< | < | ||
- | onClick=" | + | onClick=" |
Itokawa sample</ | Itokawa sample</ | ||
< | < | ||
- | onClick=" | + | onClick=" |
Itokawa sample (only low-resolution data)</ | Itokawa sample (only low-resolution data)</ | ||
< | < | ||
- | onClick=" | + | onClick=" |
Sample skeleton</ | Sample skeleton</ | ||
</ul> | </ul> | ||
</ | </ | ||
- | < | ||
These data are distributed as a sample. DO NOT use them in your actual scientific research projects. | 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. | See below for a detailed description of the dataset for AiGIS. | ||
- | ### Utilities | + | ==== Utilities |
- | #### Latitude-Longitude grid generator | + | |
- | * < | + | === Latitude-Longitude grid generator |
+ | * < | ||
<a href=" | <a href=" | ||
- | onClick=" | + | onClick=" |
makegridline.zip | makegridline.zip | ||
</a> | </a> | ||
</ | </ | ||
- | ## How to use | + | ===== How to use ===== |
- | ### Start-up | + | |
- | * Once starting-up, | + | ==== Start-up |
- | * 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 | + | * Sample data are distributed from the same place you get AiGIS |
- | * Windows user may requested to install a VC++ library to run 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 | ||
+ | |||
+ | ==== Data ==== | ||
- | ### Data | + | |
- | * 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 |
- | * 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. |
- | * 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 '#' |
- | * A line starting '#' | + | * See below for Map data and Graph map data formats |
- | * See below for Map data and Graph map data formats | + | |
- | </ | ||
{{: | {{: | ||
- | < | + | ==== Model manipulation |
- | ### Model manipulation | + | |
- | * 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 | + | |
- | * with ' | + | |
- | * Asteroid rotation and light source direction can be changed by using dialog in the main window | + | |
- | * Uncheck “View> | + | |
- | * Better to use when you view a grayscale map data | + | |
- | * Check " | + | |
- | * Select " | + | |
- | ### Work with Map data | + | * Rotate the asteroid by mouse operation |
- | * Select a data to view in the Map data list | + | * with Shift key to move the light source direction |
- | * Arrow keys (up/down) can be used to change the data | + | * with Option key or use wheel to zoom in and out |
- | * Click on the model to extract values on the polygon (Clicked polygon will be colored with red) | + | * with Control key to translating the asteroid |
- | * Values can be copied to your clipboard with the “Copy” button | + | * with ' |
- | * Rainbow and grayscale are available as built-in look-up-tables (LUT) for Map data | + | * Asteroid rotation and light source direction can be changed by using dialog in the main window |
- | * User-defined LUTs can be imported (see below) | + | * Uncheck " |
- | * Select " | + | * Better to use when you view a grayscale map data |
- | * Select " | + | * Check " |
- | * Select " | + | * Select " |
+ | |||
+ | ==== Work with Map data ==== | ||
+ | |||
+ | | ||
+ | * Arrow keys (up/down) can be used to change the data | ||
+ | * 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" | ||
+ | * Rainbow and grayscale are available as built-in look-up-tables (LUT) for Map data | ||
+ | * User-defined LUTs can be imported (see below) | ||
+ | * Select " | ||
+ | * Select " | ||
+ | * Select " | ||
- | </ | ||
{{: | {{: | ||
- | < | ||
- | #### User-defined LUTs | + | === User-defined LUTs === |
- | - Definition of a LUT should be described in the txt format appeared in [Scientific colour-maps](http:// | + | |
- | - Place your LUTs in a directory | + | * Definition of a LUT should be described in the txt format appeared in [[http:// |
- | - Path to the directory with user-defined LUTs should be defined in LookUpTablePath of the Setting dialog (“File> | + | |
- | - List of the user-defined LUTs will appeared in Look-up Table menu (" | + | |
+ | | ||
+ | |||
+ | ==== Work with Graph map data ==== | ||
- | ### 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 |
- | * NIRS_COUNT in the Itokawa sample data set is associated with NIRS Spectra data | + | * Click on the model to select the target polygon (Clicked polygon will be colored with red) |
- | * Click on the model to select the target polygon (Clicked polygon will be colored with red) | + | * Click " |
- | * Click " | + | * Plots can be added to the plot window to repeat this operation |
- | * Plots can be added to the plot window to repeat this operation | + | * Click "save chart" in a plot window to export plot data |
- | * Click "save chart" in a plot window to export plot data | + | |
- | </ | ||
{{: | {{: | ||
{{: | {{: | ||
- | < | + | ==== Image and Map image mapping ==== |
- | ### Image and Map image mapping | + | |
- | * Choose | + | * Images in general image formats (jpg, png...) and FITS format can be loaded to AiGIS. |
- | * Images in general image formats (jpg, png...) and FITS format can be loaded to AiGIS. | + | * Now you can map multiple images on the shape model |
- | * Now you can map multiple images on the shape model | + | * Control on mapping order and show/hide images is available in Texture tab |
- | * Control on mapping order and show/hide images is available in Texture tab | + | * Geometry information should be provided in the INFO format used in [[http:// |
- | * Geometry information should be provided in the INFO format used in [Small Body Mapping Tool developed by APL/JHU](http:// | + | |
- | + | ||
- | </ | + | |
{{: | {{: | ||
{{: | {{: | ||
{{: | {{: | ||
- | < | ||
- | ### Multi-view mode | + | ==== Multi-view mode ==== |
- | * Choose | + | |
- | * Uncheck | + | |
- | * Select | + | * Uncheck |
+ | * Select | ||
- | </ | ||
{{: | {{: | ||
- | < | + | ==== Setting-up ==== |
+ | |||
+ | Preferences on directories for data, saved images, and saved plot data can be set in the Setting Pane at "File>Settings..." | ||
+ | |||
+ | === Items in the Setting Pane === | ||
- | ### Setting-up | + | |
- | Preferences on directories for data, saved images, and saved plot data can be set in the Setting Pane at “File> | + | * SavePngPath: |
- | #### Items in the Setting Pane | + | * SaveGraphDataPath: |
- | * DefaultDataPath: | + | * LookUpTablePath: |
- | * SavePngPath: | + | * <del>defaultImageMapPath: |
- | * SaveGraphDataPath: | + | * NOTE to Windows users: Path delimiters should be doubled in the setting. |
- | * LookUpTablePath: | + | * For example, your path to ' |
- | * ~~defaultImageMapPath: | + | |
- | * NOTE to Windows users: Path delimiters should be doubled in the setting. | + | |
- | * For example, your path to 'C:\Users\CurrentUserName\AiGISData' should be indicated 'C:\\Users\\CurrentUserName\\AiGISData' | + | |
+ | ===== Menus ===== | ||
- | ## Menus | + | ==== File menu ==== |
- | ### File menu | + | |
- | </ | + | |
{{: | {{: | ||
- | < | ||
- | * 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 | + | * 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 |
- | * Setting...: Set preferences on user data directories | + | * Setting...: Set preferences on user data directories |
- | * About...: Show an About window | + | * About...: Show an About window |
- | ### View menu | + | ==== View menu ==== |
- | </ | ||
{{: | {{: | ||
- | < | ||
- | * 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, Grayscale and user-defined LUTs) | ||
- | * Shading: Turn on/off direct lighting | ||
- | * Reset view: Reset the view to the initial state | ||
- | * Fixed Light: fix the lighting direction to the target body *(NEW)* | ||
- | ### Multi-View menu | + | * 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, Grayscale and user-defined LUTs) | ||
+ | * Shading: Turn on/off direct lighting | ||
+ | * Reset view: Reset the view to the initial state | ||
+ | * Fixed Light: fix the lighting direction to the target body //(NEW)// | ||
+ | |||
+ | ==== Multi-View menu ==== | ||
{{: | {{: | ||
- | < | + | |
- | * 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 Views: Uncheck to stop synchronized operation to the models in the Multi-view mode | + | * Sync All Views: Synchronize displays in the Multi-view mode |
- | * Sync All Views: Synchronize displays in the Multi-view mode | + | |
- | ### Image menu | + | ==== Image menu ==== |
- | </ | + | |
{{: | {{: | ||
- | < | + | |
- | * 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 | + | |
- | ### MapData menu | + | ==== MapData menu ==== |
- | </ | + | |
{{: | {{: | ||
{{: | {{: | ||
- | < | + | |
- | * Sort By Name/By FileName: Sort MapData in the list *(NEW)* | + | * Select " |
- | * Select " | + | |
+ | ===== Data format ===== | ||
+ | |||
+ | ==== Map data ==== | ||
- | ## Data format | ||
- | ### Map data | ||
Sample: Itokawa_elevation_64.txt | Sample: Itokawa_elevation_64.txt | ||
- | ``` | + | |
+ | < | ||
#Data Name (Appeared on the Map data list) | #Data Name (Appeared on the Map data list) | ||
Elevation | Elevation | ||
Line 237: | Line 228: | ||
49152 | 49152 | ||
#Polygon_ID Value (Tab and Space is allowed as delimiter) | #Polygon_ID Value (Tab and Space is allowed as delimiter) | ||
- | 1 -3.451888084411621 | + | 1 |
#Continue for all polygones | #Continue for all polygones | ||
- | 2 -3.431725025177002 | + | 2 |
- | 3 -3.906290054321289 | + | 3 |
- | 4 -4.018442153930664 | + | 4 |
- | 5 -4.496425151824951 | + | 5 |
- | ``` | + | </ |
+ | |||
+ | === Notes on Map data === | ||
+ | |||
+ | * No duplicated Data Name is allowed for map data for a model | ||
+ | * Hyphen ' | ||
+ | * A line starting '#' | ||
- | #### Notes on Map data | + | ==== Graph map data ==== |
- | * No duplicated Data Name is allowed for map data for a model | + | |
- | * Hyphen ' | + | |
- | * 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) | Sample: nirs_spcmap_051116.txt (NIRS Spectra) | ||
- | ``` | + | |
+ | < | ||
#Name of Map data that the graph map data is associated | #Name of Map data that the graph map data is associated | ||
NIRS_COUNT | NIRS_COUNT | ||
Line 267: | Line 261: | ||
#Continue for all polygones ... | #Continue for all polygones ... | ||
2 0.000000 0.000000 0.000000 0.000000 ... | 2 0.000000 0.000000 0.000000 0.000000 ... | ||
- | ``` | + | </ |
- | #### Notes on Graph Map data | + | === Notes on Graph Map data === |
- | * Lines starting | + | |
+ | | ||
+ | |||
+ | ===== Data set structure ===== | ||
- | ## Data set structure | ||
Minimum contents of the data set directory for AiGIS are as follows: | Minimum contents of the data set directory for AiGIS are as follows: | ||
- | * AiGIS_setting.txt | + | * **AiGIS_setting.txt** |
- | * Shapemodel directory | + | * **Shapemodel** directory |
- | * MapData directory | + | * **MapData** directory |
- | * MapDataHigh 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. | + | |
+ | 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. | ||
+ | |||
+ | If a data set have 3 or more shape models, these directories will be assessed to load map data for additional shape models: | ||
+ | * **MapData1** for the **SHAPE1** model | ||
+ | * **MapData2** for the **SHAPE2** model | ||
+ | * same for MapData3, 4, ... | ||
+ | * **MapDataHigh1** for the **SHAPEHIGH1** model | ||
+ | * **MapDataHigh2** for the **SHAPEHIGH2** model | ||
+ | * same for MapDataHigh3, | ||
+ | |||
+ | |||
+ | ==== Items in AiGIS_setting.txt ==== | ||
- | ### 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 | All items in AiGIS_setting.txt are described in KEY = VALUE style. Multiple VALUES may be assigned in the following format | ||
- | ``` | + | |
+ | < | ||
KEY = VALUE1, | KEY = VALUE1, | ||
- | ``` | + | </code> |
- | * 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/ | + | |
- | * Path to additional map data for the low-resolution model and high-resolution model not placed in MapData/ | + | |
- | * CHARTDATA (optional) | + | |
- | * Path to graph map data. Error will be occurred when a graph map data doesn' | + | |
- | * GRID (optional, this keyword may be renamed in future) | + | |
- | * Path to **directory** containing data of additional 3D objects | + | |
- | * IMAGEMAPDIR (optional) | + | |
- | * Path to **directory** containing image data and relating geometry information files | + | |
- | ## History | + | * SHAPE (mandatory) |
- | * 2019/ | + | * Path to the low-resolution shape model in the relative path style from the directory placed AiGIS_setting.txt |
- | * Support FITS image (including multibyte image) | + | * SHAPEHIGH (optional) |
- | * Support SUMFILEs of SPC as imaging geometry information | + | * Path to the high-resolution shape model. |
- | * Support user-defined look-up-tables (LUT) | + | * GRIDR/GRIDW (mandatory) |
- | * 2019/ | + | * 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. |
- | * Improved image mapping capability with multi-image mapping | + | * CHANGEMODEL (optional) |
- | * Quick reloading of map data | + | * 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. |
- | * Fixed lighting mode | + | * MAPDATA/ |
- | * Fixed-axis rotation mode | + | * Path to additional map data for the low-resolution model and high-resolution model not placed in MapData/ |
- | * Reorganized preference setting feature | + | * CHARTDATA (optional) |
- | * 2018/ | + | * Path to graph map data. Error will be occurred when a graph map data doesn' |
- | * Improve multi-view mode with high-resolution shape models | + | * GRID (optional, this keyword may be renamed in future) |
- | * Rebuild user interfaces | + | * Path to **directory** containing data of additional 3D objects |
- | * Fix several bugs | + | * IMAGEMAPDIR (optional) |
- | * 2018/ | + | * Path to **directory** containing image data and relating geometry information files |
- | * Initial release | + | |
+ | If a data set have 3 or more shape models, the following KEYs can be used: | ||
+ | |||
+ | * SHAPE1, SHAPE2 ... | ||
+ | * SHAPEHIGH1, SHAPEHIGH2 ... | ||
+ | |||
+ | Keywords MAPDATA, MAPDATAHIGH, | ||
+ | |||
+ | The numbered two models (e.g. SHAPE1 and SHAPEHIGH1) will be paired for the CHANGEMODEL function. | ||
+ | ===== History | ||
+ | |||
+ | * 2023/ | ||
+ | * Support multiple (3 or more) shape models | ||
+ | * Support macOS Ventura and Sonoma | ||
+ | * 2023/ | ||
+ | * Fix bugs relating shape model handling | ||
+ | * 2019/ | ||
+ | * Support FITS image (including multibyte image) | ||
+ | * Support SUMFILEs of SPC as imaging geometry information | ||
+ | * Support user-defined look-up-tables (LUT) | ||
+ | * 2019/ | ||
+ | * Improved image mapping capability with multi-image mapping | ||
+ | * Quick reloading of map data | ||
+ | * Fixed lighting mode | ||
+ | * Fixed-axis rotation mode | ||
+ | * Reorganized preference setting feature | ||
+ | * 2018/ | ||
+ | * Improve multi-view mode with high-resolution shape models | ||
+ | * Rebuild user interfaces | ||
+ | * Fix several bugs | ||
+ | * 2018/ | ||
+ | * Initial release | ||
+ | |||
+ | ===== Contact ===== | ||
- | ## Contact | ||
Please send your questions and comments to Naru Hirata (naru@u-aizu.ac.jp) or our group mail address (arcspace@u-aizu.ac.jp). | Please send your questions and comments to Naru Hirata (naru@u-aizu.ac.jp) or our group mail address (arcspace@u-aizu.ac.jp). | ||
- | ## Reference | + | ===== Reference |
- | [Hirata N. et al. (2018) AiGIS: A 3D-GIS for Visualization of Map and Shape of Irregular-Shaped Small Bodies, LPS XLIX, Abstract #1849.](https:// | + | |
- | [Fujii Y. et al. (2007) Visualization | + | * [[https:// |
- | [Hirata N. et al. (2008) A GIS-Oriented Analysis | + | * [[https:// |
+ | * [[https:// | ||
+ | ===== Acknowledgements ===== | ||
+ | |||
+ | AiGIS was originally developed as a research project by students at the University of Aizu.\\ | ||
+ | The project is/was supported by: | ||
+ | * JSPS KAKENHI Grant Number 17K05639, " | ||
+ | * ARC-Space, the University of Aizu, Distinctive Joint Research Center supported by MEXT Grant Number JPMXP0619217839/ | ||
+ | * Collaborative research between [[https://jlpeda.jaxa.jp/en/index.html|JLPEDA/JAXA]] and the University of Aizu. | ||
+ | |||
+ | [[https:// | ||
- | ## Acknowledgements | ||
- | 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, " | ||
- | Aizu Laboratory, Inc. supports development and maintenance of the software. | ||
- | </ |
aigis/top.1673776708.txt.gz · Last modified: 2023/01/15 18:58 by Naru Hirata