computeAstro

This command takes in input a CSV file containing dates and generates a CSV file containing astronomical computations, like planets or houses.
Implemented by class observe\commands\computeAstro.
It uses an ephemeris computation library located in vendor/tig12/tigeph.
Example of command specification : 
planets:
  command: computeAstro
  input-file: tmp/insee/a00/ymd.csv
  output-file: tmp/insee/a00/planets.csv
  engine: meeus1
  skip: '0000-00-00'
  actions:
    - C SO MO ME VE MA JU SA UR NE PL NN
    - M SO MO ME VE MA JU SA UR NE PL NN
    - F SO MO ME VE MA JU SA UR NE PL NN
    - W SO MO ME VE MA JU SA UR NE PL NN

input-file

Absolute or relative path to the CSV file to transform.
Relative paths are relative to the root directory of observe, containing run-observe.php and config.yml.

output-file

Absolute or relative path to the generated CSV file.
Relative paths are relative to the root directory of observe, containing run-observe.php and config.yml.

actions

Parameter actions permits to specify a list of things to execute.
These are computed for each line of the input file.
Each action is composed by a list of words separated by one or more white space(s).
  • The first word specifies the name of the column name in the input file. This column must contain a ISO 8601 date (YYYY-MM-DD or YYYY-MM-DD HH:MM:SS).
    For CSV containing a header (the first line contains the column names), the name of the column must be used.
    For CSV without a header (the first line directly contains data), the index of the column (starting by 0) must be used.
  • The other words must contain IAA codes that must be computed
    IAA codes are defined in file vendor/tig12/tigeph/model/IAA.php
For example, "W SO MO ME VE MA JU SA UR NE PL NN" means "Use column named W in the input file and pass its value to class computeAstro to compute SO ... NN".

engine

Parameter used to specify which ephemeris computation routine will be used.
Available engines :
  • swetest : uses Swiss Ephemeris computation ; suitable when high precision is needed.
  • meeus1 : uses Jean Meeus book "Astronomical Formulae for Calculator", 1st edition ; suitable when low precision is sufficient (e.g. for dates without time).

skip

Optional parameter. If the specified value is found in the input file, astronomical computation is not done and replaced by an empty string.

Output file

The generated file is a CSV file containing the result of astronomical computations.
In this file, names of columns are : name of the input column, followed by an hypen (-), followed by IAA code.
Ex: W SO MO ME VE MA JU SA UR NE PL NN will generate columns W-SO, W-MO etc.