Difference between revisions of "RSE File"

From OpenRocket wiki
Jump to navigation Jump to search
m (Undo revision 7457: Undo my own erroneous edit.)
(Added correct units and reformatted)
 
(3 intermediate revisions by 3 users not shown)
Line 11: Line 11:
 
== XML Tags ==
 
== XML Tags ==
 
=== Engine Tag Attributes ===  
 
=== Engine Tag Attributes ===  
*mfg= text string. Manufacturer.
+
Boolean values are represented by either the integer 1 for true or the integer 0 for false. Note that all attributes, including numbers, must be passed in as strings (in quotation marks).  If the motor file is poorly formatted (values are missing or incorrect), OpenRocket will not display them in the motor menu, and the error message can only be viewed in the Debug Log under Help.
*code= text string.  Motor Designation(e.g. F128-6)
+
 
*Type= text string. one of : ("single-use" | "hybrid" | "reloadable" )  Other values are accepted, but not recognized.
+
* mfg: String = Manufacturer
*dia=Number. units = ??
+
* code: String = Motor Designation (e.g. "F128-6")
*len= Number. Units = ??                                   
+
* Type: String = Motor Classification; one of : ("single-use" | "hybrid" | "reloadable" )  Other values are accepted, but not recognized.
*initWt= Initial Weight.  Number. Units = ??
+
* dia: Number (millimeters) = Diameter
*propWt= Propellant Weight. Units = ??
+
* len: Number (millimeters) = Length
*delays="1000"
+
 
*auto-calc-mass="1"
+
* initWt: Number (grams) = Initial Weight
*auto-calc-cg="0"                                                         
+
* propWt: Number (grams) = Propellant Weight
*avgThrust="280.059"
+
 
*peakThrust="428.329"
+
* delays: Number (milliseconds?) = Motor ejection delay times. Optional list of comma separated numbers
*throatDia="0."
+
 
*exitDia="0."
+
* auto-calc-mass: Number (boolean) = Should automatically calculate the change in mass of the motor over the burn time. The mass is calculated from the thrust curve by assuming a constant exhaust velocity (mass decrease is proportional to thrust).
* Itot="21.284"
+
* auto-calc-cg: Number (boolean) = Should automatically calculate center of gravity. The CG is assumed to be located at the center of the motor casing                                                 
* burn-time="0.08"
+
 
* massFrac="99.88"
+
==== Not Used by OpenRocket ====
* Isp="2.71"
+
OpenRocket can read these files without many of the available options. I suspect that EngEdit automatically calculates them for you, but they are not necessary for OpenRocket simulations.
* tDiv="10"  
+
 
* tStep="-1."
+
* massFrac: Number = Mass Fraction. OpenRocket always recalculates with (initWt - propWt) / initWt
* tFix="1"  
+
* Isp: Number (seconds) = [Specific Impulse](https://wiki.openrocket.info/List_of_useful_custom_expressions#Specific_impulse_.28Isp.29)
*FDiv="10"  
+
* Itot: Number (Newton-seconds) = Total Impulse
*FStep="-1."  
+
* burn-time: Number (seconds) = Burn Time
*FFix="1"  
+
* avgThrust: Number (Newtons) = Average Thrust
*mDiv="10"  
+
* peakThrust: Number (Newtons) = Maximum Thrust
*mStep="-1."  
+
 
*mFix="1" cgDiv="10"
+
* throatDia: Number (Millimeters?) = Nozzle Throat Diameter
*cgStep="-1."  
+
* exitDia: Number (Millimeters?) = Nozzle Exit Diameter
*cgFix="1">
+
 
 +
* tDiv = "10"
 +
* tStep = "-1."
 +
* tFix = "1"
 +
* FDiv = "10"  
 +
* FStep = "-1."  
 +
* FFix = "1"  
 +
* mDiv = "10"  
 +
* mStep = "-1."  
 +
* mFix = "1"  
 +
* cgDiv = "10"
 +
* cgStep = "-1."  
 +
* cgFix = "1"
  
 
=== Engine Tag Children ===
 
=== Engine Tag Children ===
Line 46: Line 58:
  
 
*data
 
*data
A list of "eng-data" tags.  Together this list will define the thrust curve (and other properties which change over time.
+
A list of "eng-data" tags.  Together this list will define the thrust curve (and other properties which change over time).
 
   
 
   
 
==== eng-data Tag Attributes ====                                                                                                                       
 
==== eng-data Tag Attributes ====                                                                                                                       
*time ("t"): number. units = ??
+
* t: Number (seconds) = Time
*force ("f"): number. units = ??
+
* f: Number (Newtons) = Force of thrust
*mass ("m"): number. units = ??
+
* m: Number (grams) = Total motor mass. Instantly overrides the initWt header, but there is no verification that they are identical
*center of gravity location: ("cg"): number. units = ??
+
* cg: Number (millimeters) = Center of gravity of the entire motor, measured from the leading edge of the motor
  
 
== Example File ==  
 
== Example File ==  

Latest revision as of 20:03, 12 December 2021


Introduction[edit]

Also called "RockSim XML format" and using an '.rse" extension, these files are used to describe a motor for loading into Rocksim and OpenRocket.

RockSim v8 uses either the RASP or the new RockSim XML format (.rse). The .rse format can store extra information about the motors, such as the type of engine it is (single-use, reloadable, hybrid).

For more information about entering motor information into Rocksim, please also read the FAQ entry: [1]

XML Tags[edit]

Engine Tag Attributes[edit]

Boolean values are represented by either the integer 1 for true or the integer 0 for false. Note that all attributes, including numbers, must be passed in as strings (in quotation marks). If the motor file is poorly formatted (values are missing or incorrect), OpenRocket will not display them in the motor menu, and the error message can only be viewed in the Debug Log under Help.

  • mfg: String = Manufacturer
  • code: String = Motor Designation (e.g. "F128-6")
  • Type: String = Motor Classification; one of : ("single-use" | "hybrid" | "reloadable" ) Other values are accepted, but not recognized.
  • dia: Number (millimeters) = Diameter
  • len: Number (millimeters) = Length
  • initWt: Number (grams) = Initial Weight
  • propWt: Number (grams) = Propellant Weight
  • delays: Number (milliseconds?) = Motor ejection delay times. Optional list of comma separated numbers
  • auto-calc-mass: Number (boolean) = Should automatically calculate the change in mass of the motor over the burn time. The mass is calculated from the thrust curve by assuming a constant exhaust velocity (mass decrease is proportional to thrust).
  • auto-calc-cg: Number (boolean) = Should automatically calculate center of gravity. The CG is assumed to be located at the center of the motor casing

Not Used by OpenRocket[edit]

OpenRocket can read these files without many of the available options. I suspect that EngEdit automatically calculates them for you, but they are not necessary for OpenRocket simulations.

  • throatDia: Number (Millimeters?) = Nozzle Throat Diameter
  • exitDia: Number (Millimeters?) = Nozzle Exit Diameter
  • tDiv = "10"
  • tStep = "-1."
  • tFix = "1"
  • FDiv = "10"
  • FStep = "-1."
  • FFix = "1"
  • mDiv = "10"
  • mStep = "-1."
  • mFix = "1"
  • cgDiv = "10"
  • cgStep = "-1."
  • cgFix = "1"

Engine Tag Children[edit]

  • comments

String. Text Description

  • data

A list of "eng-data" tags. Together this list will define the thrust curve (and other properties which change over time).

eng-data Tag Attributes[edit]

  • t: Number (seconds) = Time
  • f: Number (Newtons) = Force of thrust
  • m: Number (grams) = Total motor mass. Instantly overrides the initWt header, but there is no verification that they are identical
  • cg: Number (millimeters) = Center of gravity of the entire motor, measured from the leading edge of the motor

Example File[edit]

<engine-database>
  <engine-list>
    <engine FDiv="10" FFix="1" FStep="-1." Isp="195.96" Itot="39.78" Type="reloadable" auto-calc-cg="1" auto-calc-mass="1"
    avgThrust="18.082" burn-time="2.2" cgDiv="10" cgFix="1" cgStep="-1." code="E18" delays="4,8" dia="24." exitDia="0." initWt="57." 
    len="70." mDiv="10" mFix="1" mStep="-1." massFrac="36.32" mfg="Aerotech" peakThrust="31." propWt="20.7" tDiv="10" tFix="1" 
    tStep="-1." throatDia="0.">
      <data>
        <eng-data cg="35." f="0." m="20.7" t="0."/>
        <eng-data cg="35." f="31." m="20.3774" t="0.04"/>
        <eng-data cg="35." f="30." m="14.6638" t="0.4"/>
        <eng-data cg="35." f="26.7" m="8.7629" t="0.8"/>
        <eng-data cg="35." f="19.1" m="3.99638" t="1.2"/>
        <eng-data cg="35." f="8." m="1.17602" t="1.6"/>
        <eng-data cg="35." f="2.2" m="0.11448" t="2."/>
        <eng-data cg="35." f="0." m="0." t="2.2"/>
      </data>
    </engine>
  </engine-list>
</engine-database>