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>RequiredDescription
PredictsFile "<Filename>"YesName of input CSSI predicts file
FxmFile "<Filename>"YesName of output .fxm file
StartTime "<StartTime>"YesStart time for output flux data. Entered in connect date units.
StopTime "<StopTime>"YesStop time for output flux data. Entered in connect date units.
RandomSeed <Value>NoSeed used for random number generator, maintained from run to run. Specify as a negative integer value.
F10SigmaLevel {<Value> | Random}NoSigma 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}NoSigma 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}NoTurns 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>"NoSpecify 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.

Examples

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

GenFluxHistory * PredictsFile "C:\ProgramData\AGI\STK 12\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 12\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 12\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 12\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"

Return message

Group membership

This command belongs to the following group(s):

Scenarios

Version

11