$flux = new Astro::Flux( $quantity, $type, $waveband );
    

The first three parameters must be defined. They are:

  quantity - numerical value for the flux, my be a primitive, or a
             C<Number::Uncertainty> object.
  type - type of flux. Can be any string.
  waveband - waveband for the given flux. Must be an C<Astro::WaveBand> object.
    

If any of the parameters are undefined, the constructor will throw an error. If the waveband parameter is not an "Astro::WaveBand" object, the constructor will throw an error.

The type is case-insensitive for lookups using the "quantity" method.

A fourth optional argument may be passed; this is a hash containing the following optional keys:

  quality - an C<Misc::Quality> object denoting quality flags for the
    C<Astro::Flux> object.
  reference_waveband - an C<Astro::WaveBand> object denoting a reference
    waveband for the C<Astro::Flux> object. This is used for determining
    magnitudes when deriving them from C<Astro::FluxColor> objects. See
    C<Astro::Fluxes>.
  datetime - an C<DateTime> object which is the datetime of observation for the
    measurement in the C<Astro::Flux> object.
  obsid - An array reference to a list of observation identifiers. Can be
    used to identify the observation(s) from which this measurement was
    taken (e.g. from a filename).
    

  my $mag = $flux->quantity('mag');
    

No conversions are done between types. What you put in via the constructor is all you can get out, so if you specify the type to be 'magnitude' and you ask for a 'mag', this method will throw an error.

The type is case-insensitive.

  my $mag = $flux->error('mag');
    

No conversions are done between types. What you put in via the constructor is all you can get out, so if you specify the type to be 'magnitude' and you ask for a 'mag', this method will throw an error.

The type is case-insensitive.

Errors are only returned if one was created with the object.

  my $waveband = $flux->waveband;
    

Returns an "Astro::WaveBand" object.

  my $quality = $flux->quality;
    

Returns an "Misc::Quality" object if defined. If not, returns undef.

  my $ref_waveband = $flux->reference_waveband;
    

Returns an "Astro::WaveBand" object if defined. If not, returns undef.

  my $datetime = $flux->datetime;
  $flux->datetime( new DateTime );
    

Returns an "Date::datetime" object if defined. If not, returns undef.

  my $obsid = $flux->obsid;
  $flux->obsid( $obsid );
    

Returns an array reference if defined. If not, returns undef.

  my $type = $flux->type;
    

Cannot be used to set the type.