Decodes the ILcdModelReference that is associated with a data source.
Some formats do not include information about the coordinate system that is used in their data files. For these
formats, an additional model reference file may be placed next to the data file, providing information about the
coordinate system. ILcdModelDecoder implementations for these formats often allow to configure an
ILcdModelReferenceDecoder on them, providing the model decoder with the correct coordinate
Returns the model reference, associated with the specified data source.
aDataSourceName - a data source for which to return the model reference; typically a file name or a URL.
the ILcdModelReference associated with the data source. While null is allowed, implementors are advised to throw an error instead.
java.io.IOException - if the ILcdModelReference cannot be decoded. It is recommended
to throw a FileNotFoundException when the source passed does not point to an existing file. This allows
to differentiate between missing model reference files and corrupt model reference files.
When the thread on which this method is called is interrupted, it is recommended to stop the decoding
and throw an InterruptedIOException.
This same exception can also be used if the decoder shows UI to the user, and the user cancels the decoding
through the UI.