7. Reference and troubleshooting#
Supporting scripts#
JOBuilder.py#
python scripts/JOBuilder.py <processing_type> <processor_version> <input_folder> [mission_phase]
Argument |
Description |
Example |
|---|---|---|
|
|
|
|
Format |
|
|
Root processing folder |
|
|
Required only for STA/STA_chain |
|
JOBuilder.py reads config.ini from the same directory.
config.ini#
After the sed substitution from
step 1,
config.ini already points at your local paths. The file is reproduced
here for reference; see
scripts/config.ini
for the live version.
[TEMPLATE_JO]
L1F = ~/bps-work/BPS/docs/tutorials/run-bps-locally/CONFIGURATION_FILE/JO_TEMPLATE/BIO_L1F_P_TEMPLATE_JobOrder.xml
L1 = ~/bps-work/BPS/docs/tutorials/run-bps-locally/CONFIGURATION_FILE/JO_TEMPLATE/BIO_L1_P_TEMPLATE_JobOrder.xml
STA = ~/bps-work/BPS/docs/tutorials/run-bps-locally/CONFIGURATION_FILE/JO_TEMPLATE/BIO_STA_P_TEMPLATE_JobOrder.xml
L2A = ~/bps-work/BPS/docs/tutorials/run-bps-locally/CONFIGURATION_FILE/JO_TEMPLATE/BIO_L2A_P_ALL_TEMPLATE_JobOrder.xml
[AUX_STATIC]
DEM = ~/bps-work/bps/internal_resources/DEM
FNF = ~/bps-work/bps/internal_resources/FNF
GMF = ~/bps-work/bps/internal_resources/GMF
IRI = ~/bps-work/bps/internal_resources/IRI
[AUX]
AUX_DEFAULT_DIR = ~/bps-work/BPS/docs/tutorials/run-bps-locally/CONFIGURATION_FILE/AUX_443
AUX_USER_DIR = ~/bps-work/BPS/docs/tutorials/run-bps-locally/CONFIGURATION_FILE/AUX_USER
The AUX_STATIC block points at static auxiliary data (DEM, FNF, GMF,
IRI) installed with the bundle under
<conda-env>/share/bps/internal_resources/. Either symlink that folder or
update the paths to match your install.
set_environment.bash#
Activates the BPS conda environment and sets LD_LIBRARY_PATH for the
native L1 framing library. Sourced automatically by the bps443 alias
added during install. When installing a new version, update the top of the
file:
BPS_DOCKER_TAG="04.43"
BPS_PYTHON_ENV=BPS_443
Troubleshooting#
The conda solver crashes during installation
Your system RAM is below 20 GB. Free up memory (close other applications) or add RAM. On a workstation with 16 GB or less, install one processor at a time instead of the whole bundle, or use the cloud-based MAAP setup.
No L1F JobOrder files found
JOBuilder.py failed silently. Check processing_L1F.log in your
INPUT_FOLDER. The most common causes are an incorrect template path in
config.ini or a missing RAW__0S file in Inputs/.
AUX_INS___ not found
The AUX_INS file is missing from Inputs/, AUX_USER_DIR and
AUX_DEFAULT_DIR. Verify that config.ini points to the correct AUX
version folder for your BPS version.
STA produces an error about insufficient products
You downloaded only a single repeat cycle. STA needs multiple acquisitions over the same frame. Re-download a full major cycle (7 repeat passes).
libl1framing.so: cannot open shared object file
The L1 framing native library is missing from LD_LIBRARY_PATH. Make
sure you sourced set_environment.bash (or ran the bps443 alias)
before launching the processor. Source-install users: confirm
bps-l1_binaries was installed in
step 3.3.
bps_l1_processor crashes with “shared memory” error on Linux
/dev/shm is too small. Check its size with df -h /dev/shm and remount
larger if needed: sudo mount -o remount,size=12G /dev/shm.
Source-install: ModuleNotFoundError: No module named ‘arepytools’
Aresys-provided Python deps are pulled from PyPI when you run
pip install -e .. If a package is private to Aresys, install the bundle
version of the package via conda from the bundle channel:
conda install -c "file://$HOME/bps-work/SW/BPS_V443/bundle/bps_conda_channel" arepytools
Next steps#
Browse the Science Guide for the algorithmic details of each processor (L1 SAR, AGB, FH, FD).
See the User Guide for end-user reference documentation.
Source-install users: see the Contributing guide to open a pull request against any Python processor.
Report a bug or suggest an improvement to the example scripts in the BPS issue tracker.