All the important and valuable things on your farm are represented as "assets" in farmOS. Assets include Plantings, Animals, Equipment, etc.
Assets are organized into different sections in the farmOS interface, and can be accessed from the main menu. You can add assets from within each asset type's dashboard.
Each asset type will have it's own set of fields, but some of the common ones include:
- Name (required) - The name of the asset.
- Location - This is actually not a real field. It is a shortcut for creating a log that assigns the asset to a location. For more information see Movements and location.
- Photos - This field lets you attach photos to your asset.
- Description - This is a simple text tield that you can use to describe each asset in further detail. It can be used to take notes, but it is recommended that any activities be recorded using logs instead, because they have a timestamp associated with them.
- Flags - Flags can be added to assets (as well as logs and areas) for easier searching/filtering. Some flags are provided by default (eg: "Prioity", "Needs Review", "Monitor"), and modules can provide additional flags (eg: "Organic" and "Not Organic" provided by the Organic module).
Asset cluster maps¶
In the dashboard of each asset, there is an "asset cluster map" that displays counts of assets in a map, along with the geometries of their locations.
They are called "cluster" maps because they use a feature of the Openlayers mapping library called a "Cluster source". This means that the location of all assets of a particular type (eg: animals) are loaded into a map at once, and they are "clustered" into points based on their proximity to one another.
So if you have 20 animals all within the same relative area, you will see a single point with a "20" on it. You can click on that point to see a list of the animals, and if you zoom in, that point will automatically break up into multiple other cluster points, showing more precise locations.
Here's a little more nitty-gritty on how this works: logs are used to record the location of assets in farmOS, along with a geometry field for storing precise geodata about location. This geometry is being loaded into cluster maps twice. The first is to draw the actual geometry of the asset location. And the second is to generate the cluster points. The points themselves are just the "centroid" of the geometry itself - which basically means it's the average centerpoint, represented in latitude and longitude. So by displaying both the actual geometry, and the centroid points, you're able to get a very nice overview of exactly where assets are on your farm. Pretty cool huh?
Assets can be archived so they do not show in farmOS unless you specifically want to see them. So for example, when you are done harvesting a planting, you can mark it as "archived" to hide it in the list of plantings. Archived records can be retrieved using the "Filters" options on asset listing pages.
Assets can be cloned by selecting one or more in a list and clicking the "Clone" button that appears at the bottom. This will clone the asset record(s), but will not clone the logs that are associated with them.