XINA Struct Mine

The XINA Struct Mine utility processes archive files to produce data products for import into XINA. It is primarily intended to be run as part of the XINA Structs data pipeline's Mining Task. There are 2 suppported archive file formats: xbin and xpf. If the archive file is in the xpf format, processing is delegated to a mission specific tool. See the Struct Extract Interface that describes the interface the tool shall implement.
Arguments

Name
Req
Description
Default

task
✓
task ID

conf
✓
JSON conf file path

temp
✓
temp directory path

import
✓
import directory path (for file outputs)

post
✓
post directory path (for post-import outputs)

host

tunnel host
"localhost"

port

tunnel port
41746

Configuration

Name
Req
Description
Default

pipe
✓
pipe group path, or model path if no pipe

t
✓
start time of archive to mine. Can be specified as either a numeric microseconds since unix epoch or an ISO8601 string such as "2025-02-17T00:00:00Z"

use_pkt_time

If true, use packet time when extracting data. Only applicable for projects that support both ground and packet time.
false

pkt

Deprecated alias for use_pkt_time

write_unbinned

If true, write the unbinned (aka delta/full) data files and import actions.
true

write_binned_secs

Array of binned db seconds to write and import. An empty array will not write any binned data. Not including the key will write all binned data. Example: [60] will write only the 60 second binned data.
All binned data will be written and imported

Operation
This utility serves a few main functions:

Extract data from archive files to produce import products such as:

Full mnemonic data
Delta mnemonic data
Time and Interval bin data
Filtered mnemonic data
Events (Actions?)
Limit Report
Metrics
Mission Specific Data