Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
calc_areas [2026/06/29 14:06]
chrystian Add ASPHAA reference to Calc Areas documentation 		calc_areas [2026/08/28 03:09] (current)
hermann Sync from local documentation review
Line 1: Line 1:
-====== Calc Areas ====== ​+====== Calc Areas ======
  
 ===== Description ===== ===== Description =====
Line 8: Line 8:
  
 ^ Name  ^ Type  ^ Description ​ ^ ^ Name  ^ Type  ^ Description ​ ^
-| Source ​ | [[Categorical Map Type|Categorical Map]]  | Map whose non-null cells correspond to categories or classes. ​ | +| Source ​ | [[Categorical Map Type]] ​ | Map whose non-null cells correspond to categories or classes. ​ | 
-| Use Authalic Area  | [[Boolean Value Type|Boolean Value]]  | If set to true, the area of each cell in a geographic ​grid (Lat/Long) is computed using an authalic sphere, which preserves surface area during projection. This improves the accuracy of area calculations across all latitudes by avoiding distortions ​in geographic coordinate systems. If the grid is geographic but the flag is set to false, all cells are treated as having the same area, calculated by treating the length of one degree of latitude or longitude as a constant 111255 meters. ​ | + 
-===== Output ​=====+===== Optional Inputs ===== 
 + 
 +^ Name  ^ Type  ^ Description ​ ^ Default Value  ^ 
 +| Use Authalic Area  | [[Boolean Value Type]] ​ | If true, the area of each cell in a geographic (Lat/​Long) ​grid is computed using an authalic sphere, which preserves surface area during projection. This improves the accuracy of area calculations across all latitudes by avoiding distortions. If the grid is geographic but this option ​is false, all cells are treated as having the same area, calculated by treating the length of one degree of latitude or longitude as a constant 111255 meters. This is an advanced port.  | Yes  | 
 + 
 +===== Outputs ​=====
  
 ^ Name  ^ Type  ^ Description ​ ^ ^ Name  ^ Type  ^ Description ​ ^
-| Areas  | [[Table Type|Table]]  | Area of each map category ​in cells, hectares and square meters. ​ |+| Areas  | [[Table Type]] ​ | Area of each source feature, ​in cells, hectares, and square meters. ​ |
  
 ===== Group ===== ===== Group =====
  
-[[Functor List#Map Algebra|Map Algebra]]+[[Functor List#Map Algebra | Map Algebra]]
  
 ===== Notes ===== ===== Notes =====
  
-Only the areas corresponding to class or categories ​defined ​in the input map header ​are calculated.+Only the areas of classes ​or categories ​present ​in Source'​s categorization ​are calculated; other values are ignored.
  
-The table containing the resulting ​area has the following format.+The resulting ​table has the following format.
  
 ^ Column Name  ^ Key or Data?  ^ Column Type  ^ Description ​ ^ ^ Column Name  ^ Key or Data?  ^ Column Type  ^ Description ​ ^
Line 31: Line 36:
 | "​Area_In_Square_Meters" ​ | Data  | Real  | Area of corresponding category in square meters ​ | | "​Area_In_Square_Meters" ​ | Data  | Real  | Area of corresponding category in square meters ​ |
  
-==== References ​====+**References**
  
 Santini, M., Taramelli, A. and Sorichetta, A., 2010: [[https://​www.researchgate.net/​publication/​220606016_ASPHAA_A_GIS-Based_algorithm_to_calculate_cell_area_on_a_latitude-longitude_Geographic_regular_grid|ASPHAA:​ A GIS-Based Algorithm to Calculate Cell Area on a Latitude-Longitude (Geographic) Regular Grid]]. Transactions in GIS, 14(3), 351-377. Santini, M., Taramelli, A. and Sorichetta, A., 2010: [[https://​www.researchgate.net/​publication/​220606016_ASPHAA_A_GIS-Based_algorithm_to_calculate_cell_area_on_a_latitude-longitude_Geographic_regular_grid|ASPHAA:​ A GIS-Based Algorithm to Calculate Cell Area on a Latitude-Longitude (Geographic) Regular Grid]]. Transactions in GIS, 14(3), 351-377.
Line 42: Line 47:
  
 See practical examples of this functor in [[lesson_9|Lesson 9: Working with maps and tables]] See practical examples of this functor in [[lesson_9|Lesson 9: Working with maps and tables]]
 +