topsApp.py -h
2025-09-05 17:37:11,675 - isce.insar - INFO - ISCE VERSION = 2.6.3, RELEASE_SVN_REVISION = ,RELEASE_DATE = 20230418, CURRENT_SVN_REVISION = 
ISCE VERSION = 2.6.3, RELEASE_SVN_REVISION = ,RELEASE_DATE = 20230418, CURRENT_SVN_REVISION = 
None
The currently supported sensors are:  ['SENTINEL1']

Usages: 
topsApp.py <input-file.xml>
topsApp.py --steps
topsApp.py --help
topsApp.py --help --steps


See the table of configurable parameters listed 
below for a list of parameters that may be specified in the
input file.  See example input xml files in the isce 'examples'
directory.  Read about the input file in the ISCE.pdf document.

The user configurable inputs are given in the following table.
Those inputs that are of type 'component' are also listed in
table of facilities below with additional information.
To configure the parameters, enter the desired value in the
input file using a property tag with name = to the name
given in the table.
name                        type       mandatory  doc                           
=========================== ========== ========== ==============================
ampcormargin                int        False      Ampcor margin offset. Used in 
                                                  runDenseOffsets.              
ampcoroversamplingfactor    int        False      Ampcor oversampling factor.   
                                                  Used in runDenseOffsets.      
ampcorsearchwindowheight    int        False      Ampcor search window size     
                                                  height. Used in               
                                                  runDenseOffsets.              
ampcorsearchwindowwidth     int        False      Ampcor search window size     
                                                  width. Used in                
                                                  runDenseOffsets.              
ampcorskipheight            int        False      Ampcor skip down height. Used 
                                                  in runDenseOffsets.           
ampcorskipwidth             int        False      Ampcor skip across width. Used
                                                  in runDenseOffsets.           
ampcorwindowheight          int        False      Ampcor main window size       
                                                  height. Used in               
                                                  runDenseOffsets.              
ampcorwindowwidth           int        False      Ampcor main window size width.
                                                  Used in runDenseOffsets.      
applyionospherecorrection   bool       False      N/A                           
applypolynomialfitbeforefil bool       False      N/A                           
teringionospherephase                                                           
areasmaskedoutinionospheric int        False      areas masked out in           
phaseestimation                                   ionospheric phase estimation  
azimuthlooks                int        False      N/A                           
azimuthshift                int        False      Ampcor gross offset down. Used
                                                  in runDenseOffsets.           
considerburstpropertiesinio bool       False      N/A                           
nospherecomputation                                                             
correctphaseerrorcausedbyio int        False      N/A                           
nosphereazimuthshift                                                            
demfilename                 str        False      Filename of the Digital       
                                                  Elevation Model (DEM)         
demstitcher                 component  False      Object that based on the frame
                                                  bounding boxes creates a DEM  
dodenseoffsets              bool       False      Perform dense offset          
                                                  estimation                    
doesd                       bool       False      Perform ESD estimation        
dointerferogram             bool       False      Perform interferometry. Set to
                                                  false to skip insar steps.    
doionospherecorrection      bool       False      N/A                           
dounwrap                    bool       False      True if unwrapping is desired.
                                                  To be unsed in combination    
                                                  with UNWRAPPER_NAME.          
dounwrap2stage              bool       False      True if unwrapping is desired.
                                                  To be unsed in combination    
                                                  with UNWRAPPER_NAME.          
endionospherestep           str        False      N/A                           
esdazimuthlooks             int        False      Number of azimuth looks for   
                                                  overlap IFGs                  
esdcoherencethreshold       float      False      ESD coherence threshold       
esdrangelooks               int        False      Number of range looks for     
                                                  overlap IFGs                  
extraesdcycles              float      False      Extra ESD cycles to interpret 
                                                  overlap phase                 
family                      str        False      Instance family name          
filternullfactor            float      False      NULL factor to use in         
                                                  filtering offset fields to    
                                                  avoid numpy type issues.      
filterstrength              float      False      N/A                           
filterwindowsize            int        False      Window size for median_filter.
geocodeboundingbox          float      False      Bounding box for geocoding -  
                                                  South, North, West, East in   
                                                  degrees                       
geocodedemfilename          str        False      Filename of the DEM for       
                                                  geocoding                     
geocodelist                 str        False      List of products to geocode.  
heightofionospherelayerinkm float      False      N/A                           
maximumwindowsizeforfilteri int        False      N/A                           
ngionosphereazimuthshift                                                        
maximumwindowsizeforfilteri int        False      N/A                           
ngionospherephase                                                               
minimumwindowsizeforfilteri int        False      N/A                           
ngionosphereazimuthshift                                                        
minimumwindowsizeforfilteri int        False      N/A                           
ngionospherephase                                                               
name                        str        False      Instance name                 
numberofazimuthlooksatfirst int        False      N/A                           
stageforionospherephaseunwr                                                     
apping                                                                          
numberofrangelooksatfirstst int        False      N/A                           
ageforionospherephaseunwrap                                                     
ping                                                                            
offsetgeocodelist           str        False      List of offset-specific files 
                                                  to geocode.                   
offsetsnrthreshold          float      False      Offset SNR threshold          
pickledumpdirectory         str        False      If steps is used, the         
                                                  directory in which to store   
                                                  pickle objects.               
pickleloaddirectory         str        False      If steps is used, the         
                                                  directory from which to       
                                                  retrieve pickle objects.      
rangelooks                  int        False      N/A                           
rangeshift                  int        False      Ampcor gross offset across.   
                                                  Used in runDenseOffsets.      
reference                   component  True       Reference raw data component  
regionofinterest            float      False      User defined area to crop in  
                                                  SNWE                          
renderer                    str        True       Format in which the data is   
                                                  serialized when using steps.  
                                                  Options are xml (default) or  
                                                  pickle.                       
rununwrapper                component  False      Unwrapping module             
rununwrapper2stage          component  False      Unwrapping module             
secondary                   component  True       Secondary raw data component  
sensorname                  str        True       Sensor name                   
snrthresholdfactor          float      False      SNR Threshold factor used in  
                                                  filtering offset field        
                                                  objects.                      
solver_2stage               str        False      Linear Programming Solver for 
                                                  2Stage; Options: pulp, gurobi,
                                                  glpk; Used only for Redundant 
                                                  Arcs                          
startionospherestep         str        False      N/A                           
swaths                      int        False      Swaths to process             
topsproc                    component  False      TopsProc object               
totalnumberofazimuthlooksin int        False      N/A                           
theionosphereprocessing                                                         
totalnumberofrangelooksinth int        False      N/A                           
eionosphereprocessing                                                           
unwrapper2stagename         str        False      2 Stage Unwrapping method to  
                                                  use. Available: MCF, REDARC0, 
                                                  REDARC1, REDARC2              
unwrappername               str        False      Unwrapping method to use. To  
                                                  be used in combination with   
                                                  UNWRAP.                       
usegpu                      bool       False      Allow App to use GPU when     
                                                  available                     
usehighresolutiondemonly    int        False      If True and a dem is not      
                                                  specified in input, it will   
                                                  only download the SRTM highest
                                                  resolution dem if it is       
                                                  available and fill the missing
                                                  portion with null values      
                                                  (typically -32767).           
usevirtualfiles             bool       False      Use virtual files when        
                                                  possible to save space        


The configurable facilities are given in the following table.
Enter the component parameter values for any of these facilities in the
input file using a component tag with name = to the name given in
the table. The configurable parameters for a facility are entered with 
property tags inside the component tag. Examples of the configurable
parameters are available in the examples/inputs directory.
For more help on a given facility run
iscehelp.py -t type
where type (if available) is the second entry in the table

name                 type           
                                    
==================== ===============
demstitcher          DataManager    
reference            GRDSensor      
rununwrapper         N/A            
rununwrapper2stage   N/A            
secondary            GRDSensor      
topsproc             N/A           

根据 topsApp.py -h 的输出,以下是关于 topsproc 的解释(加粗部分为核心说明):


topsproc 的含义

topsproc 是 ISCE 软件中处理 Sentinel-1 TOPS(Terrain Observation by Progressive Scans)模式数据的核心组件,属于配置参数中的“设施”(facility)类型。其关键特性如下:

1. 功能与作用
  • 核心处理器:负责执行 Sentinel-1 数据的完整干涉处理流程,包括:
    • 数据解包(unpacking)
    • 配准(coregistration)
    • 干涉图生成(interferogram formation)
    • 相位滤波(phase filtering)等。
  • 自动化控制:通过其他参数(如 swathsdodenseoffsets)间接驱动,无需用户直接配置。
2. 配置特性
属性 说明
类型(type) N/A 无需指定子类型,其行为由全局参数控制(如 demfilenamegeocodeboundingbox
必要性 非强制 用户通常无需显式配置,系统自动初始化
输入文件关联 通过 XML 参数通过输入 XML 文件的 <component name="topsproc"> 标签传递(实际极少使用)
3. 与其他组件的关系
  • 依赖上游数据:由 reference(参考影像)和 secondary(次级影像)组件提供输入数据。
  • 驱动下游流程:若启用 dointerferogram=True,则自动触发 topsproc 的干涉处理。
  • 与 DEM 交互:依赖 demstitcher 组件提供高程模型。

为何类型标记为 N/A

  • 封装性设计topsproc 作为内部引擎,其参数已通过全局变量(如 azimuthlooksrangelooks)暴露,无需独立类型。
  • 简化操作:用户仅需关注输入数据(reference/secondary)和输出参数(如 geocodelist),无需直接操作 topsproc

使用建议

  1. 忽略显式配置:在 99% 的场景中,无需在 XML 文件内声明 <component name="topsproc">
  2. 通过全局参数控制
    <!-- 示例:通过 swaths 和 looks 参数间接控制 topsproc -->
    <property name="swaths">1,2,3</property> <!-- 处理子条带 1,2,3 -->
    <property name="azimuthlooks">4</property> <!-- 方位向 4 视 -->
    <property name="rangelooks">2</property>   <!-- 距离向 2 视 -->
    
  3. 错误排查:若处理失败,检查关联参数(如 sensorname=SENTINEL1demfilename 路径)。

✅ 总结topsproc 是 ISCE 中 Sentinel-1 数据的自动化处理引擎,用户仅需配置输入数据和全局参数,无需直接干预其内部逻辑。标记为 N/A 正因其实质为“黑盒”处理器。

Logo

有“AI”的1024 = 2048,欢迎大家加入2048 AI社区

更多推荐