Editing MaeFat
Warning: You are not logged in.
Your IP address will be recorded in this page's edit history.
The edit can be undone.
Please check the comparison below to verify that this is what you want to do, and then save the changes below to finish undoing the edit.
Latest revision | Your text | ||
Line 5: | Line 5: | ||
[[Image:maeFatInitialScreen.png|thumb|200px|alt=Screenshot of maeFat Initial Screen|Initial Screen]] | [[Image:maeFatInitialScreen.png|thumb|200px|alt=Screenshot of maeFat Initial Screen|Initial Screen]] | ||
- | When you initially run the program, there will be no data available, and you will see the display shown on the right. You must either enter data through the app, or copy a data file of your own into the proper location. Also, you must use the | + | When you initially run the program, there will be no data available, and you will see the display shown on the right. You must either enter data through the app, or copy a data file of your own into the proper location. Also, you must use the Settings menu option in order to enter your height (which is used to calculate your [[:wikipedia:Body_mass_index|Body Mass Index]] (BMI). |
{{clear}} | {{clear}} | ||
Line 12: | Line 12: | ||
[[Image:maeFatMenu.png|thumb|200px|alt=Screenshot of maeFat Menu|Menu]] | [[Image:maeFatMenu.png|thumb|200px|alt=Screenshot of maeFat Menu|Menu]] | ||
- | The image to the right shows the maeFat menu. To enter data, select the Data Entry option. The Log option allows you to edit entries which have already been entered. The | + | The image to the right shows the maeFat menu. To enter data, select the Data Entry option. The Log option allows you to edit entries which have already been entered. The Time Analysis option displays statistics about the data which has been entered. The Settings option allows you to change how the program operates, for example whether or not metric units are used. The Help option displays this page in the unit's web browser, and the About options shows a page containing copyright and other information about the program. |
{{clear}} | {{clear}} | ||
Line 23: | Line 23: | ||
If you press the arrow at the upper right corner (the normal way to exit a page) the new data will NOT be entered into the log. | If you press the arrow at the upper right corner (the normal way to exit a page) the new data will NOT be entered into the log. | ||
- | It is recommended that you not enter more than one weight entry per day, although the software allows you to do so if you wish to. | + | It is recommended that you not enter more than one weight entry per day, although the software allows you to do so if you wish to. If you enter more than 33 weight values per month, the Edit page will not work properly. |
{{clear}} | {{clear}} | ||
== Settings == | == Settings == | ||
- | + | [[Image:maeFatSettings.png|thumb|200px|alt=maeFat Settings|Settings]] | |
- | + | The Settings page allows you to change how the program operates. It must be used initially to enter your height. Before entering your height, you should select centimeter units if that's what you wish to use (rather than inches). You may also select metric units for weight, and the format for displaying the dates. If you select nonjudgemental colors, neutral colors will be used to display the data, otherwise green will be used to indicate weight loss, red will be used for weight gain, and the BMI data will be color coded. The BMI color code is: | |
- | + | ||
- | + | ||
- | + | ||
- | The | + | |
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
* '''Red''': Obese or Severely Underweight | * '''Red''': Obese or Severely Underweight | ||
Line 55: | Line 36: | ||
* '''Green''': Normal weight range | * '''Green''': Normal weight range | ||
- | You can | + | You may also set a target weight, which can be displayed as a green line on the weight vs time plot. |
- | The | + | There are two "radio box" sets of buttons. The first allows you to define |
+ | the time interval for the default weight vs time plot. The second radio box contains buttons which allow you to define whether or not a least squares fit | ||
+ | is applied to the data, and the time interval over which the fitting should | ||
+ | be done. | ||
- | |||
- | |||
- | |||
- | |||
- | |||
- | |||
- | |||
- | |||
- | |||
- | |||
- | |||
- | |||
- | |||
- | |||
- | |||
- | |||
- | |||
- | |||
- | |||
- | |||
- | |||
{{clear}} | {{clear}} | ||
Line 87: | Line 50: | ||
The program's default page shows a plot of the data you have entered, and a trend line. The yellow trend line is the exponentially weighted running average of the weight data. The scale on the left of the plot is in the weight units you have chosen. On the right is shown the corresponding BMI values. The line at the bottom presents your current weight (from the trend line, not any particular data entry), the weight lost or gained over the last week (regardless of the plot interval) and the number of excess/deficit calories per day which will produce that weight change. | The program's default page shows a plot of the data you have entered, and a trend line. The yellow trend line is the exponentially weighted running average of the weight data. The scale on the left of the plot is in the weight units you have chosen. On the right is shown the corresponding BMI values. The line at the bottom presents your current weight (from the trend line, not any particular data entry), the weight lost or gained over the last week (regardless of the plot interval) and the number of excess/deficit calories per day which will produce that weight change. | ||
- | |||
- | |||
{{clear}} | {{clear}} | ||
Line 96: | Line 57: | ||
The Trend Page shows statistical information about your weight data over differing time intervals. Initially, when little data is available, it will show only the values for the entire log history. Eventually data for the last week, fortnight (2 weeks), month (30 days), quarter (91 days) and year will be shown, when enough data is available to calculate those values. | The Trend Page shows statistical information about your weight data over differing time intervals. Initially, when little data is available, it will show only the values for the entire log history. Eventually data for the last week, fortnight (2 weeks), month (30 days), quarter (91 days) and year will be shown, when enough data is available to calculate those values. | ||
- | |||
- | |||
- | |||
{{clear}} | {{clear}} | ||
Line 110: | Line 68: | ||
The weight values shown on the Trend Page are calculated with these formulae, and the caloric excess/deficit values are calculated using the difference in trend value over the specified interval, with the assumption that one pound of weight change corresponds to 3500 calories. | The weight values shown on the Trend Page are calculated with these formulae, and the caloric excess/deficit values are calculated using the difference in trend value over the specified interval, with the assumption that one pound of weight change corresponds to 3500 calories. | ||
{{clear}} | {{clear}} | ||
+ | |||
== Estimating When You Will Reach Your Target Weight == | == Estimating When You Will Reach Your Target Weight == | ||
Line 116: | Line 75: | ||
If you have entered a target weight, and defined a fit interval (both may be set on the Settings Page), maeFat will estimate when you will reach your target weight, based on a linear least squares fit to your weight entries, over the time interval you have specified. The estimated date (and exact time of day!) that you will reach your target weight will be displayed on the Trend Page. | If you have entered a target weight, and defined a fit interval (both may be set on the Settings Page), maeFat will estimate when you will reach your target weight, based on a linear least squares fit to your weight entries, over the time interval you have specified. The estimated date (and exact time of day!) that you will reach your target weight will be displayed on the Trend Page. | ||
- | In addition, if you select the Plot | + | In addition, if you select the Plot Goal option, the weight vs time plot will show the least squares fit to your data, and the point at which that line |
- | will intersect your target weight (see plot to the right | + | will intersect your target weight (see plot to the right). |
- | + | ||
- | + | ||
{{clear}} | {{clear}} | ||
Line 130: | Line 87: | ||
[[Image:maeFatEditList.png|thumb|200px|alt=maeFat Edit List|Edit List]] | [[Image:maeFatEditList.png|thumb|200px|alt=maeFat Edit List|Edit List]] | ||
- | Once you have selected the month | + | Once you have selected the month, you will be presented with a page listing all the data entries for that month. The green weight values are the measurements that you have entered. The yellow weight values are trend weights, calculated with one of the formulae shown above. If you press on one of these entries, you will be sent to the Data Entry page, which will be preloaded with the selected day's values, where you may change the values. You may also press the Delete button to remove the entry entirely. |
- | + | ||
- | + | ||
{{clear}} | {{clear}} | ||
== Data File Format / Entering Many Data Points == | == Data File Format / Entering Many Data Points == | ||
- | If you have a pre-existing weight log that you wish to enter, it will be very tedious to enter each point individually using the GUI interface. It makes much more sense to convert your weight log into the format maeFat uses using some external script. The data is kept in the file $HOME/.maeFat/data. A backup copy is kept on the microSD card (so that if you have to reflash the N900, your log won't be lost) in the file /media/mmc1/.maeFat/data . The data file is a flat text file, with one line per log entry, using the following format: | + | If you have a pre-existing weight log that you wish to enter, it will be very tedious to enter each point individually using the GUI interface. It makes much more sense to convert your weight log into the format maeFat uses using some external script. The data is kept in the file $HOME/.maeFat/data. A backup copy is kept on the microSD card (so that if you have to reflash the N900, your log won't be lost) in the file /media/mmc1/.maeFat/data . The data file is a flat text file, with one line per log entry, using the following format: |
DD/MM/YYYY HH:MM XXX.X # Optional comment here | DD/MM/YYYY HH:MM XXX.X # Optional comment here | ||
- | where DD is the day of the month, MM is the number of the month, YYYY is the year, HH is the hour, MM is the minutes, and XXX.X is the weight. The weight | + | where DD is the day of the month, MM is the number of the month, YYYY is the year, HH is the hour, MM is the minutes, and XXX.X is the weight. The weight must be in pounds, even if maeFat has been configured to display metric units. |
+ | Any comment must be preceded by a #, but no # is needed for entries without a comment. | ||
There is no need for you to load your data into the backup file, because it will be rewritten automatically once any data is entered or edited with the program's GUI. | There is no need for you to load your data into the backup file, because it will be rewritten automatically once any data is entered or edited with the program's GUI. | ||
Line 151: | Line 107: | ||
== Availability == | == Availability == | ||
- | maeFat is available in the Extras | + | maeFat is available in the Extras-devel repository. It will be moved to Extras-testing soon. |
== Support Information == | == Support Information == |
Learn more about Contributing to the wiki.