Description | Example | Return Message | Group

GenFluxHistory

Generate daily solar flux and geomagnetic data histories in the .fxm format based on CSSI predicts files.

Syntax

GenFluxHistory <ScenarioPath> ({FluxOption} <Value>)...

Description

The GenFluxHistory command is used to generate daily solar flux and geomagnetic data histories in the .fxm format based on CSSI predicts files. The generated trajectories can incorporate a specified or single randomly drawn level of deviation of the mean solar flux behavior and superimposed daily random variations with amplitude and time correlation characteristics appropriate for the current location with the solar cycle.

The PredictsFile, FxmFile, StartTime and StopTime options are required and must be included in the command line, any of the other options can also be entered.

The following table describes the valid options and their values.

{FluxOption} <Value> Required Description
PredictsFile "<Filename>" Yes Name of input CSSI predicts file
FxmFile "<Filename>" Yes Name of output .fxm file
StartTime "<StartTime>" Yes Start time for output flux data. Entered in connect date units.
StopTime "<StopTime>" Yes Stop time for output flux data. Entered in connect date units.
RandomSeed <Value> No Seed used for random number generator, maintained from run to run. Specify as a negative integer value.
F10SigmaLevel {<Value> | Random} No Sigma level as a real number to be used for mean F10 trajectory, can also specify RANDOM instead of a number to request a random draw. The average F10 behavior is computed as the CSSI predict value plus the F10SigmaLevel multiplied by the F10 mean sigma from the CSSI predict.
ApSigmaLevel {<Value> | Random} No Sigma level as a real number to be used for mean Ap trajectory, can also specify RANDOM instead of a number to request a random draw. The average Ap behavior is computed as the CSSI predict value plus the ApSigmaLevel multiplied by the Ap mean sigma from the CSSI predict. This option has no effect currently since the Ap sigmas in the CSSI predicts are all zero.
F10DailyRandomVariation {On | Off} No Turns on or off the inclusion of daily random variations of F10.7 superimposed on the mean trajectory. These variations have amplitude and time correlation characteristics appropriate for the current location with the solar cycle. Off is the default.
RefFXMFile "<Filename>" No Specify a reference .fxm file that is used to generate history prior to requested start time. This file must contain data at least 40 days prior to the requested start time to support the computation of 81 day centered average values for F10.7. The initial daily variation for the generated flux history is computed as the difference between the deviated mean trajectory (CSSI predict plus F10SigmaLevel * F10 sigma) and the flux value from the reference solar flux trajectory.

Example

Generate a +1 sigma mean solar flux trajectory with no daily variations:

GenFluxHistory * PredictsFile "C:\ProgramData\AGI\STK 11\DynamicEarthData\SolFlx_CSSI.dat" FxmFile "C:\Temp\Test.fxm" StartTime "1 Jan 2012 00:00:00.00" StopTime "15 Jun 2012 00:00:00.00" F10SigmaLevel 1.0

Generate a random mean solar flux trajectory with no daily variations:

GenFluxHistory * PredictsFile "C:\ProgramData\AGI\STK 11\DynamicEarthData\SolFlx0304_CSSI.dat" FxmFile "C:\Temp\Test.fxm" StartTime "1 Jan 2012 00:00:00.00" StopTime "1 Jun 2012 00:00:00.00" RandomSeed -1234567 F10SigmaLevel Random

Generate a random mean solar flux trajectory with daily variations:

GenFluxHistory * PredictsFile "C:\ProgramData\AGI\STK 11\DynamicEarthData\SolFlx0304_CSSI.dat" FxmFile "C:\Temp\Test.fxm" StartTime "1 Jan 2012 00:00:00.00" StopTime "1 Jun 2012 00:00:00.00" RandomSeed -1234567 F10SigmaLevel Random F10DailyRandomVariation On

Generate a +2 sigma mean solar flux trajectory with daily variations initialized from a reference solar flux:

GenFluxHistory * PredictsFile "C:\ProgramData\AGI\STK 11\DynamicEarthData\SolFlx_CSSI.dat" FxmFile "C:\Temp\Test.fxm" StartTime "1 Jan 2012 00:00:00.00" StopTime "1 Jun 2012 00:00:00.00" F10SigmaLevel 2.0 F10DailyRandomVariation On RefFXMFile "C:\Temp\Ref.fxm"

ReturnMessage

If activated, Connect returns an acknowledgement message.

Group Membership

This command belongs to the following group(s):

Scenarios

Version

11

STK Programming Interface 11.0.1