Level1bModel

class stdatamodels.jwst.datamodels.Level1bModel(init=None, schema=None, pass_invalid_values=None, strict_validation=None, validate_on_assignment=None, validate_arrays=False, ignore_missing_extensions=True, ignore_unrecognized_tag=False, **kwargs)

Bases: JwstDataModel

A data model for raw 4D ramps level-1b products.

Attributes:
datanumpy uint16 array

The science data

zeroframenumpy uint16 array

Zeroframe array

refoutnumpy uint16 array

Reference Output

groupnumpy table

group parameters table

int_timesnumpy table

table of times for each integration

Initialize a data model.

Parameters:
initstr, tuple, astropy.io.fits.HDUList, ndarray, dict, None

  • None : Create a default data model with no shape.

  • tuple : Shape of the data array. Initialize with default data array with shape specified by the tuple.

  • file path: Initialize from the given file (FITS or ASDF)

  • readable file object: Initialize from the given file object

  • astropy.io.fits.HDUList : Initialize from the given astropy.io.fits.HDUList.

  • A numpy array: Used to initialize the data array

  • dict: The object model tree for the data model

  • DataModel: Initialize from an existing DataModel instance. This will perform a shallow copy, and will convert between model subtypes as long as their schemas are compatible.

schemadict, str (optional)

Tree of objects representing a JSON schema, or string naming a schema. The schema to use to understand the elements on the model. If not provided, the schema associated with this class will be used.

pass_invalid_valuesbool or None

If True, values that do not validate the schema will be added to the metadata. If False, they will be set to None. If None, value will be taken from the environmental PASS_INVALID_VALUES. Otherwise the default value is False.

strict_validationbool or None

If True, schema validation errors will generate an exception. If False, they will generate a warning. If None, value will be taken from the environmental STRICT_VALIDATION. Otherwise, the default value is False.

validate_on_assignmentbool or None

Defaults to ‘None’. If None, value will be taken from the environmental VALIDATE_ON_ASSIGNMENT, defaulting to ‘True’ if no environment variable is set. If ‘True’, attribute assignments are validated at the time of assignment. Validation errors generate warnings and values will be set to None. If ‘False’, schema validation occurs only once at the time of write. Validation errors generate warnings.

validate_arraysbool

If True, arrays will be validated against ndim, max_ndim, and datatype validators in the schemas.

ignore_missing_extensionsbool

When False, raise warnings when a file is read that contains metadata about extensions that are not available. Defaults to True.

ignore_unrecognized_tagbool

When False, raise warnings when an unrecognized tag is encountered. When True, ignore unrecognized tags.

**kwargs

Additional keyword arguments are expected to be array-like attributes of the data model. These will be initialized with the given values only if they are defined in the schema and the schema expects an array-like value. Kwargs are only allowed when init is None, a tuple, or a numpy array. Example usage:

model = ImageModel(data=np.ones((10, 10)), dq=np.zeros((10, 10)))

Attributes Summary

schema_url

The schema URI to validate the model against.

Methods Summary

get_default(attr)

Retrieve the schema-defined default value of an attribute.

Attributes Documentation

schema_url = 'http://stsci.edu/schemas/jwst_datamodel/level1b.schema'

The schema URI to validate the model against. If None, only basic validation of required metadata properties (filename, model_type) will occur.

Methods Documentation

get_default(attr)

Retrieve the schema-defined default value of an attribute.

Override the parent method to give zeroframe the correct shape.

Parameters:
attrstr

Attribute to set to its default value.

Returns:
object or None

The default value for the given attribute. If the attribute is schema-defined but has no default value in the schema, this will return None.

Raises:
AttributeError

If the given attribute is not defined in the schema.