StreamStats Batch Processor v{{vm.BPVersion}}   For more information, see our Batch Processor Information page.

Some Batch Processor features are currently unavailable. Please check back soon. Contact streamstats@usgs.gov for support.

The StreamStats Batch Processor allows users to run StreamStats for numerous points via an automated process.

How to Submit a Batch
  1. Create a point shapefile:
    • Shapefile coordinate system must be the same as the coordinate system of the stream grid used by StreamStats for delineation. Points must be coincident with the stream grid. Visit theDownload Stream Grids tabto download the stream grid for each State/Region.
    • Shapefile must have an ID field that uniquely identifies each point.
    • Shapefile must be a point shapefile. Polyline, polygon, and multipoint geometries cannot be processed.
    • Shapefile must be compressed to a .zip file that contains a .shp, .shx, .prj, and .dbf file in the top-level folder.
    • Only the first 250 points will be processed.
    • Only points contained within the requested State/Region will be processed.
    • Results will be provided in the same coordinate system as the shapefile.
  2. Complete the form below. Highlighted fields are required.
  3. Click the "Submit Batch" button and confirm that the batch was submitted successfully.
  4. Check your email or the "Batch Status" tab to see the batch status and retrieve file geodatabase results.
State / Region:
ID Field: This is the field heading from the shapefile of points that is unique to each point and allows the data to be joined with the batch results.

Email Address:

Upload Shapefile (.zip):
Drag file here or click:   {{vm.submitBatchData.attachment.name}}
Select Computations:

  Select Basin Delineation Options

If checked, basin delineations will occur where they are normally disallowed due to exclusionary polygons.

  Select Flow Statistics

Scenario computation has not been enabled yet for selected region.
Please select a State / Region to view Flow Statistics.
Select Statistic Group
  {{flowStat.statisticGroupName}}

  Select Basin Characteristics

Please select a State / Region to view Basin Characteristics.


Select Parameter Description
  {{parameter.code}} *   {{parameter.description}}
Batches may take several hours or days to complete. Use this tab to check the status and results of your batches.

How to Check Batch Status
  1. Enter your email address.
  2. Batch status will appear in the Status column.
  3. When results are ready for download, a hyperlink will appear in the Results column.
Email Address:
Batch ID Status Time Submitted Time Started Time Completed File Name Results State/ Region Number Points Requested Number Points Successful Number Points Partially Successful Number Points Failed
{{batch.batchID}} {{batch.statusMessage}} {{batch.timeSubmitted | date:'M/d/yy h:mm a'}} GMT {{batch.timeSubmitted | date:'Z'}} {{batch.timeStarted | date:'M/d/yy h:mm a'}} GMT {{batch.timeStarted | date:'Z'}} {{batch.timeCompleted | date:'M/d/yy h:mm a'}} GMT {{batch.timeCompleted | date:'Z'}} {{batch.uploadFileName}} Link {{batch.region}} {{batch.pointsRequested}} {{batch.pointsSuccessful}} {{batch.pointsPartiallySuccessful}} {{batch.pointsFailed}}
No batches found for this email address.
Batch points should be coincident with the stream grid used by StreamStats for delineation. Basin delineation may be disabled for batch points located within exclusion areas. Please use the links below to download the stream grid and exclusion areas for each State/Region.

State / Region Download Stream Grid Link Last Modified Date
{{streamGrid.region}} Download {{streamGrid.lastModified | date:'M/d/yyyy'}}

Stream Grids were unable to be retrieved at this time. Please contact streamstats@usgs.gov for assistance.

How to Edit the Batch Queue
  • To change the order of batches, edit the values in the Order column and click the "Reorder Order" button. Batches will proceed in the queue in numerical order.
  • To pause a batch, click the pause button in the Pause / Unpause? column. The batch will automatically be unpaused (returned to the queue) when all the batches currently in the queue have completed. The IDs of the batches required to be completed for the batch to be unpaused are listed in the "Pause List" column.
  • To manually unpause a batch, click the play button in the Pause / Unpause? column. The batch will be added to the bottom of the current queue.
  • If the server goes down in the middle of a batch, or a completed batch needs to be re-run: to restart a batch, click the refresh icon in the Refresh? column. The batch results will be deleted. When ready to start the next batch in the queue, click the "Start Next Batch" button at the bottom of the page, which will start the next batch, if the server has capacity.
  • To delete a batch, click the trash can icon in the Delete? column.
  • If there are batches in the queue but no batches currently running, the server may have experienced errors and needs a new "worker" started. Click the "Start Next Batch" button to kick off a worker. The next batch will be started, if the server has capacity.
Select Queue to Manage:
Select a Date Range:

Batch ID Order Email Address Status Pause List Time Submitted Time Started Time Completed File Name Results State/ Region Number Points Requested Number Points Successful Number Points Partially Successful Number Points Failed Pause / Unpause? Refresh? Delete?
{{batch.batchID}} {{batch.order}} {{batch.emailAddress}} {{batch.statusDescription}} {{batch.queueList}} {{batch.timeSubmitted | date:'M/d/yy h:mm a'}} GMT {{batch.timeSubmitted | date:'Z'}} {{batch.timeStarted | date:'M/d/yy h:mm a'}} GMT {{batch.timeStarted | date:'Z'}} {{batch.timeCompleted | date:'M/d/yy h:mm a'}} GMT {{batch.timeCompleted | date:'Z'}} {{batch.uploadFileName}} Link {{batch.region}} {{batch.pointsRequested}} {{batch.pointsSuccessful}} {{batch.pointsPartiallySuccessful}} {{batch.pointsFailed}}
No batches found.
{{vm.submitBatchOver250Message}}
The batch was submitted successfully. You will be notified by email when results are available.
The batch failed to submit.