Appendix A: The IUnidadGeoEstadistica interface

The IUnidadGeoEstadistica interface holds a series of methods that allow retrieving spatially aggregated data by invoking siguanet_quest functions. In most cases, it's a one-to-one mapping: one method invokes one corresponding function. It is the responsibility of the implementing class to define which function will be invoked. In fact, the 6 classes that implement this interface define 6 aggregation levels and semantically group siguanet_quest functions from the "geography" point on view. So, to some extent, Quest object model documents and gives more sense to the bunch of siguanet_quest functions.
You do need to know the method names in this interface in order to properly configure the Quest module, which probably is the handiest tool inside siguanet-desktop. You'll also need to make a clear difference between scalar methods and those returning a collection of enclosures. When configuring the Quest module, just remember that you're defining "data access points" for your users. You normally define several measurements for each point. Defining a measurement basically means supplying:

• the name of a method returning a scalar;
• the name of a method (if one is available) returning the collection of objects being measured, that is enclosures or locations which match the scalar method's criteria.

In the following sections we'll classify the scalar methods according to what they measure and point to its corresponding collection method so that you can easily configure the Quest module. Methods listed belong to the IUnidadGeoEstadistica interface unless stated otherwise.

Count methods

Return an integer expressing a number of enclosures or a number of employee locations.

Scalar method	Collection method	Description
NumEstancias	ObtenerEstancias1	Total number of enclosures.
NumEstanciasUtiles	ObtenerEstanciasUtiles	Number of occupiable enclosures.
NumEstanciasDocentes	ObtenerEstanciasDocentes	Number of teaching rooms.
NumEstanciasOcupadas	ObtenerEstanciasOcupadas	Number of occupied rooms.
NumEstanciasNoOcupadas	ObtenerEstanciasNoOcupadas	Number of empty rooms.
NumDespachosOcupados	ObtenerDespachosOcupados	Number of occupied office rooms.
NumDespachosNoOcupados	ObtenerDespachosNoOcupados	Number of empty office rooms.
NumAdmonOcupados	ObtenerAdmonOcupados	Number of occupied administration service rooms.
NumAdmonNoOcupados	ObtenerAdmonNoOcupados	Number of empty administration service rooms.
NumPersonas	ObtenerUbicaciones	Total number of employees.
BaseOrg.NumPersonasNoUbicados2	BaseOrg.ObtenerUbicacionesPendientes2	Number of employees whose location is unknown.
NumPAS	ObtenerUbicacionesPAS	Number of administration and service employees.
BaseOrg.NumPASNoUbicados2	BaseOrg.ObtenerUbicacionesPASPendientes2	Number of administration and service employees whose location is unknown.
NumPDI	ObtenerUbicacionesPDI	Number of teaching and research employees.
BaseOrg.NumPDINoUbicados2	BaseOrg.ObtenerUbicacionesPDIPendientes2	Number of teaching and research employees whose location is unknown.
NumPDICargos	ObtenerUbicacionesPDI	Number of teaching and research employees with governing responsibilities.
BaseOrg.NumPDICargosNoUbicados2	BaseOrg.ObtenerUbicacionesPDICargosPendientes2	Number of teaching and research employees with governing responsibilities whose location is unknown.
NumBecarios	ObtenerUbicacionesBecarios	Number of scholarship holders.
BaseOrg.NumBecariosNoUbicados2	BaseOrg.ObtenerUbicacionesBecariosPendientes2	Number of scholarship holders whose location is unknown.
NumExternos	ObtenerUbicacionesExternos	Number of external employees.
BaseOrg.NumExternosNoUbicados2	BaseOrg.ObtenerUbicacionesExternosPendientes2	Number of external employees whose location is unknown.

¹ Do not use collection method in Raw Spatial Tree.
² When dealing with "pending" locations, the scalar and collection method belong only to the BaseOrg class, which matches the highest level of aggregation.

Area methods

Return a double precision number that measures the area covered by a group enclosures in square metres.

Scalar method	Collection method	Description
SuperficieEstancias	ObtenerEstancias1	Total number of enclosures.
SuperficieEstanciasUtiles	ObtenerEstanciasUtiles	Area of occupiable enclosures.
SuperficieEstanciasDocentes	ObtenerEstanciasDocentes	Area of teaching rooms.
SuperficieEstanciasOcupadas	ObtenerEstanciasOcupadas	Area of occupied rooms.
SuperficieEstanciasNoOcupadas	ObtenerEstanciasNoOcupadas	Area of empty rooms.
SuperficieDespachosOcupados	ObtenerDespachosOcupados	Area of occupied office rooms.
SuperficieDespachosNoOcupados	ObtenerDespachosNoOcupados	Area of empty office rooms.
SuperficieAdmonOcupados	ObtenerAdmonOcupados	Area of occupied administration service rooms.
SuperficieAdmonNoOcupados	ObtenerAdmonNoOcupados	Area of empty administration service rooms.

¹ Do not use collection method in Raw Spatial Tree.

Rate methods

Return a double precision number expressing square meters available per employee or a percentage.

Scalar method	Collection method	Description
CalcularDensidad	-	Occupation rate for all employees in square meters per employee.
BaseOrg.PorcentajePersonasNoUbicados1	BaseOrg.ObtenerUbicacionesPendientes1	Percentage of employees whose location is unknown.
CalcularDensidadPAS	-	Occupation rate for administration and service employees in square meters per employee.
BaseOrg.PorcentajePASNoUbicados1	BaseOrg.ObtenerUbicacionesPASPendientes1	Percentage of administration and service employees whose location is unknown.
CalcularDensidadPDI	-	Occupation rate for teaching and research employees in square meters per employee.
BaseOrg.PorcentajePDINoUbicados1	BaseOrg.ObtenerUbicacionesPDIPendientes1	Percentage of teaching and research employees whose location is unknown.
CalcularDensidadPDICargos	-	Occupation rate for teaching and research employees with governing responsibilities in square meters per employee.
BaseOrg.PorcentajePDICargosNoUbicados1	BaseOrg.ObtenerUbicacionesPDICargosPendientes1	Percentage of teaching and research employees with governing responsibilities whose location is unknown.
CalcularDensidadBecarios	-	Occupation rate for scholarship holders in square meters per employee.
BaseOrg.PorcentajeBecariosNoUbicados1	BaseOrg.ObtenerUbicacionesBecariosPendientes1	Percentage of scholarship holders whose location is unknown.
CalcularDensidadPDI	-	Occupation rate for external employees in square meters per employee.
BaseOrg.PorcentajeExternosNoUbicados1	BaseOrg.ObtenerUbicacionesExternosPendientes1	Percentage of external employees whose location is unknown.

¹ When dealing with "pending" locations, the scalar and collection methods belong only to the BaseOrg class, which matches the highest level of aggregation.